| Code | Status | Detail |
|---|---|---|
invalid_value | 400 | The information you entered isn’t valid. Please check it and try again. |
unauthenticated | 401 | Authentication is required. |
forbidden | 403 | You do not have permission to perform this action. |
external_account_not_found | 404 | External account not found. |
multiwallet_not_enabled | 404 | Multiwallet is not enabled. |
wallet_not_found | 404 | Wallet not found. |
agent_not_active | 409 | The agent must be active for this operation. |
already_exists | 409 | The resource already exists. |
bank_account_already_linked | 409 | This bank account is already linked. |
conflict | 409 | The request conflicts with the current resource state. |
default_wallet_cannot_be_detached | 409 | Make another wallet the agent’s default before detaching this wallet. If this is the agent’s only wallet, attach another wallet first. |
default_wallet_cannot_be_frozen | 409 | Make another active standard wallet the default before freezing this wallet. |
external_account_not_verified | 409 | External account must be verified before it can be used. |
insufficient_funds | 409 | Insufficient funds. |
transfer_failed | 409 | Transfer failed. |
wallet_closed | 409 | Closed wallets cannot change freeze status. |
wallet_frozen_by_natural | 409 | This wallet was frozen by Natural and cannot be unfrozen through this endpoint. |
wallet_not_active | 409 | The wallet must be active for this operation. |
vault_not_allowed | 422 | Agents cannot be attached to vault wallets. |
rate_limited | 429 | Too many requests. Please try again later. |
server_error | 500 | Something went wrong. |
bad_gateway | 502 | We couldn’t complete that request because one of Natural’s services returned an unexpected response. Please try again. |
service_unavailable | 503 | The service is temporarily unavailable. |
Resource errors
Wallets
Public error codes for Wallets API endpoints
All error responses follow the standard error format.
Validation errors (422) and rate limit errors (429) apply to all endpoints and are documented in the Error Handling guide.