> ## Documentation Index
> Fetch the complete documentation index at: https://docs.natural.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transfers

> Public error codes for Transfers API endpoints

All error responses follow the standard [error format](/api-reference/errors/error-handling).
Validation errors (422) and rate limit errors (429) apply to all endpoints and are documented in the [Error Handling guide](/api-reference/errors/error-handling).

| Code                                         | Status | Detail                                                                                                                                           |
| -------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `invalid_pagination_cursor`                  | 400    | Invalid pagination cursor.                                                                                                                       |
| `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.                                                                                                                      |
| `transfer_not_found`                         | 404    | Transfer not found.                                                                                                                              |
| `wallet_not_found`                           | 404    | Wallet not found.                                                                                                                                |
| `already_exists`                             | 409    | The resource already exists.                                                                                                                     |
| `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.                                                                                           |
| `external_account_not_verified`              | 409    | External account must be verified before it can be used.                                                                                         |
| `insufficient_funds`                         | 409    | Insufficient funds.                                                                                                                              |
| `insufficient_funds`                         | 409    | The linked bank account has insufficient funds for this transfer.                                                                                |
| `transfer_failed`                            | 409    | Transfer failed.                                                                                                                                 |
| `deposit_balance_unverified_limit_exceeded`  | 422    | Deposits are limited to \$1,000 per day until your bank account balance can be verified. Reconnect your bank account to restore your full limit. |
| `deposit_tier_daily_pull_limit_exceeded`     | 422    | This deposit exceeds the remaining daily bank-pull limit. Send a wire directly to your wallet to move the full amount today.                     |
| `transfer_limit_exceeded`                    | 422    | This transfer exceeds a limit on your account.                                                                                                   |
| `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.                                                                                                          |
