| Code | Status | Detail |
|---|---|---|
external_party_account.validation_failed | 400 | External party account failed bank account validation. |
external_party.archived | 400 | External party is archived. |
external_party.screening_not_clear | 400 | External party screening must be clear before wire payment creation. |
invalid_value | 400 | The information you entered isn’t valid. Please check it and try again. |
pagination.invalid_cursor | 400 | Invalid pagination cursor. |
policy.denied | 400 | Wire payment was denied by policy. |
wallet.insufficient_balance | 400 | Wallet has insufficient available balance. |
wallet.required | 400 | Select a wallet for this wire payment. |
wire.beneficiary_address_required | 400 | Add a complete beneficiary address with PATCH /external-parties//address before creating a wire. Keep the existing recipient and account IDs. |
wire.invalid_originator_information | 400 | Customer legal name and remittance information must fit the 140-character Fedwire information field. |
wire.not_cancellable | 400 | Wire payment is not cancellable. |
wire.rejected | 400 | Wire payment could not be initiated. |
unauthenticated | 401 | Authentication is required. |
forbidden | 403 | You do not have permission to perform this action. |
policy.forbidden | 403 | Wire payment is not allowed by policy. |
wire.not_enabled | 403 | Wire payments are not enabled for this program. |
not_found | 404 | The requested resource was not found. |
already_exists | 409 | The resource already exists. |
conflict | 409 | The request conflicts with the current resource state. |
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. |
wallet.balance_unavailable | 503 | Wallet balance is temporarily unavailable. |
Resource errors
Wire
Public error codes for Wire 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?