Errors

Error format

Each error object carries title, code and message.

HTTP statuses
HTTP status	When
400	Field validation failed.
403	Access control denied the request, or `x-client-id` / `x-api-key` are missing on webhook endpoints.
404	The account, payment or card does not exist or does not belong to the client.
500	Internal error, or the service is temporarily unavailable.

{
  "status": "ERROR",
  "errors": [
    {
      "title": "Account not found",
      "code": "OPEN-BANKING-011",
      "message": "Account not found."
    }
  ]
}

Frequently returned codes

Frequently returned error codes
Code	Meaning
`OPEN-BANKING-003`	Forbidden.
`OPEN-BANKING-004`	Validation failed.
`OPEN-BANKING-008`	Currency not found.
`OPEN-BANKING-009`	Country not found.
`OPEN-BANKING-011`	Account not found.
`OPEN-BANKING-012`	Card not found.
`OPEN-BANKING-029`	Invalid payload in the code-for-token exchange.
`OPEN-BANKING-030`	Invalid authorization token.
`OPEN-BANKING-033`	Payment not found.
`OPEN-BANKING-034`	Payment is in an invalid state for this operation.
`OPEN-BANKING-038`	User not found.
`OPEN-BANKING-042`	Webhook not found.
`OPEN-BANKING-046`	Unsupported currency.
`OPEN-BANKING-047`	Limit not found.
`OPEN-BANKING-048`	Limit check failed.
`OPEN-BANKING-050`	Fee calculation failed.
`OPEN-BANKING-051`	Card is in an invalid state for this operation.
`OPEN-BANKING-053`	Route not found.