Getting Started

Errors

HTTP status codes

StatusMeaning
200Success
201Resource created
400Bad request — invalid or missing parameters
401Unauthorized — invalid or missing API key
403Forbidden — key lacks permission for this operation
404Not found
408Request timeout
429Rate limited
5xxServer error — safe to retry with idempotency where applicable

Error response format

1{
2  "error_code": "VALIDATION_ERROR",
3  "message": "Human-readable explanation",
4  "details": {}
5}

Use error_code for programmatic handling; message text may change over time.

Common error categories

CategoryTypical cause
authentication_errorMissing or invalid x-api-key
validation_errorInvalid request body or query parameters
transfer_errorPayout/payin state or rail-specific issue
bank_account_errorPayment method or verification problem
server_errorInternal failure — retry with idempotency when appropriate

See endpoint-specific error responses in the API Reference tab.