Error format

Swap endpoints share the public API error envelopes. The per-endpoint validation messages are listed on each endpoint page.

Missing / invalid API key

{
  "success": false,
  "message": "Missing api key",
  "statusCode": 0
}

Include the apiKey header in every request. docs.omypayments.com/api/authentication

Validation error (400 Bad Request)

{
  "success": false,
  "message": "Validation error",
  "errors": [
    {
      "field": "amount",
      "messages": ["Invalid value format"]
    }
  ]
}

No permission (403 Forbidden)

The API key does not have the swap permission enabled.

{
  "success": false,
  "message": "You have no permissions for this action",
  "statusCode": 403
}

Internal error (500)

{
  "success": false,
  "message": "Internal Server Error",
  "statusCode": 500
}