| 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_pagination_cursor | 400 | The page cursor is not valid. Start the list again. |
invalid_value | 400 | The information you entered isn’t valid. Please check it and try again. |
unauthenticated | 401 | Authentication is required. |
external_account_not_card | 403 | Only saved cards can be removed here. Bank accounts can only be removed by their owner. |
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. |
idempotency_key_reused | 409 | This idempotency key was already used for a different request. Use a new key only for a genuinely new operation. |
idempotency_request_in_progress | 409 | A request with this idempotency key is still processing. Retry the same request with the same key. |
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.
Was this page helpful?