Errors and Rate Limits

All application error responses include an error code, a human-readable message, and optional parameters providing additional context.

{
  "code": "bad_request.invalid_param.amount",
  "message": "Invalid format for amount (valid: '10.00 NZD')",
  "params": {}
}

Field

Type

Description

code

string

A machine-readable error code identifying the type of error

message

string

A human-readable description of the error

params

object

Additional parameters related to the error (optional)

API errors will be returned with an appropriate HTTP status codes in the 4XX range.

Rate Limiting

The API may rate limit with a 429 status code.

Volley will check with you regarding appropriate rate limiting during onboarding.