| Code | Status | Detail |
|---|---|---|
external_account_auth_consent_required | 400 | Additional Plaid Auth consent is required before this bank account can be linked. |
external_account_auth_data_not_ready | 400 | Plaid Auth data is not ready for this bank account. Try again later. |
external_account_auth_permission_required | 400 | Plaid Auth permission is required before this bank account can be linked. |
external_account_institution_unavailable | 400 | The financial institution is temporarily unavailable. Try again later or use another bank account. |
external_account_link_failed | 400 | Unable to link this bank account. |
external_account_no_auth_accounts | 400 | No eligible checking, savings, or cash management account is available to link. |
external_account_no_eligible_accounts | 400 | No eligible bank accounts are available to link. |
external_account_not_supported | 400 | This bank account is not supported for linking. |
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. |
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_connection_disconnected | 409 | External account connection is disconnected. |
external_account_connection_login_required | 409 | External account connection requires reauthentication. |
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
External Accounts
Public error codes for External Accounts 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.