Errors

The error object

The error object contains both a high level error code and an array of detailed error codes and messages. The root object has the following members:

status: The HTTP error status code
code: The error code
errors: An array containing one or more error codes and messages

In case the error comes from the provider, the returned error code is provider_error and the provider's error is parsed into the errors array.

Error codes

The below table is a non-comprehensive list of error codes:

Status	Code	Error	Description
`400`	`provider_error`	`bad_request`	a provider specific message is included
`400`	`bad_request`	`bad_request`	Invalid parameters or malformed syntax
`400`	`bad_request`	`customer_unknown`	Invalid customer_id. Use a valid customer_id or authenticate to a bank to continue
`400`	`bad_request`	`account_unknown`	Invalid account_id. You must specify an account_id as defined by the /accounts API
`400`	`bad_request`	`session_id_invalid_or_expired`	The session ID used is either expired or invalid
`400`	`bad_request`	`invalid_field`	The value or format of field [field] is incorrect
`400`	`bad_request`	`mandatory_field_missing`	The mandatory field is missing: [field] has not been defined
`400`	`bad_request`	invalid_debited_account`	Invalid debited_account_id. The debited_account_type is set to internal, please use an id provider by the accounts API
`401`	`unauthorized`	`invalid_token`	The token is either invalid or expired
`401`	`unauthorized`	`invalid_scopes`	Your app does not have the necessary scopes to access this API
`401`	`unauthorized`	`invalid_code`	The authorization code is either wrong or expired
`401`	`unauthorized`	`invalid_app_id`	Invalid app_id
`401`	`unauthorized`	`invalid_app_url`	Invalid app redirect URL
`404`	`not_found`	`not_found`	The requested resource could not be found. The requested resource either does not exist or is temporarily down
`429`	`too_many_requests`	`too_many_requests`	The user has sent too many requests in a given amount of time
`500`	`internal_server_error`	`internal_server_error`	An internal error has occurred. If the error persists, please contact our support
`501`	`not_implemented`	`provider_endpoint_unavailable`	The provider endpoint is currently unavailable or has not been implemented yet
`503`	`service_unavailable`	`provider_unavailable`	The provider is currently unavailable. Please try again later

Updated 7 months ago