---
updatedAt: 2025-03-07T22:54:22.000Z
agentTools:
  projectIndex: https://doc.fintecture.com/llms.txt
---

# 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                                                              |