| Code | Status | Detail |
|---|---|---|
external_account_link_failed | 400 | Unable to link this bank account. |
invalid_value | 400 | A request value is invalid. |
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. |
wallet_not_found | 404 | Wallet not found. |
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. |
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. |
rate_limited | 429 | Too many requests. |
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.