Learn about status and error messages for diffent Nordigen endpoints.
Learn more about each state for requisitions and accounts.
requistions endpoint
| Status short | Status long | Description |
|---|---|---|
| CR | CREATED | Requisition has been succesfully created |
| LN | LINKED | Account has been succesfully linked to requisition |
accounts endpoint
| Status long | Description |
|---|---|
| DISCOVERED | User has succesfully authenticated herself, and account has been discovered |
| PROCESSING | Account is being processed by the ASPSP |
| READY | Account has been successfully processed |
| ERROR | An error was encountered when processing account |
| SUSPENDED | Account has been suspended (more than 10 attempts to access account when in ERROR status) |
All error HTTP codes are going to be 4xx or 5xx, so we recommend using success http codes for the control flow and the error messages for informative purposes. If an error has occurred, it will be displayed in the following form:
{
"summary": "Unknown ASPSP ID",
"detail": "Get ASPSP ID from /aspsps/?country={country_code}",
"status_code": 400
}aspsps endpoint
| Summary | Detail | HTTP status |
|---|---|---|
| Unknown fields {fields} in the payload | 400 | |
| Invalid token | 401 |
agreements endpoint
| Summary | Detail | HTTP status |
|---|---|---|
| Incorrect max_historical_days | max_historical_days must be > 0 and <= {aspsp_id }transaction_total_days (int) | 400 |
| End User Agreements cannot be accepted more than once | 400 | |
| Cannot delete End User Agreement | Cannot delete accepted End User Agreement: {eua_id}. Only non accepted agreements can be deleted | 400 |
| Invalid token | 401 |
requisitions endpoint
| Summary | Detail | HTTP status |
|---|---|---|
| Invalid redirect URI | Redirect URI must have a valid URI structure" | 400 |
| Invalid EUA | {agreement_id} is not a valid UUID. Please specify valid agreement from /api/agreements/enduser/?={enduser_id} or create a new one | 400 |
| Incorrect enduser_id | enduser_id in requisition have to be the same as specified in EUA {eua_id}. Requisition enduser_id: " {req_enduser_id}, EUA enduser_id {eua_enduser_id} | 400 |
| Provided user_language is invalid or not supported | {user_language} is invalid or not supported language | 400 |
| Invalid token | 401 |
accounts endpoint
| Summary | Detail | HTTP status |
|---|---|---|
| Account state does not permit accessing {trx\|balances\|details} | Try re-connect account | 400 |
| Account exists but there is no valid enduser agreement permitting you to access it | 400 | |
| Invalid Account ID | {id} is not a valid UUID | 400 |
| Account suspended | This Account or its Requisition was suspended due to numerous errors that occurred while accessing it | 409 |
| Couldn't update account {balances\|details\|transactions} | Request limit exceeded For every authenticated end user, you can update data 4 times per day | 429 |
| Couldn't update account {balances\|details\|transactions} | Request to ASPSP returned error (including when 90 day access tokens has expired) | 500 |
| Couldn't update account {balances\|details\|transactions} | ASPSP service unavailable | 503 |
| Invalid token | 401 |