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 |
| SU | SUSPENDED | Requisition is suspended due to numerous consecutive errors that happened while accessing its accounts |
accounts endpoint
| Status long | Description |
|---|---|
| DISCOVERED | User has succesfully authenticated herself, and account has been discovered |
| ERROR | An error was encountered when processing account |
| EXPIRED | Access to account has expired as set in End User Agreement |
| PROCESSING | Account is being processed by the ASPSP |
| READY | Account has been successfully processed |
| SUSPENDED | Account has been suspended (more than 10 consecutive failed attempts to access the account) |
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 |
|---|---|---|
| Invalid Account ID | {id} is not a valid UUID | 400 |
| End User Agreement (EUA) {eua_id} has expired | EUA was valid for {valid_days} days and it expired at {expired_date}. The end user must connect the account once more with new EUA and Requisition | 400 |
| AccessExpiredError | Access has expired or it has been revoked. To restore access reconnect the account | 401 |
| AccountInactiveError | Account has been deactivated or it no longer exists | 401 |
| Invalid token | 401 | |
| Account suspended | This Account or its Requisition was suspended due to numerous errors that occurred while accessing it | 409 |
| RateLimitError | Daily request limit set by the Institution has been exceeded | 429 |
| UnknownRequestError | Request to institution returned unknown error | 500 |
| ServiceError | Institution service unavailable | 503 |
| ConnectionError | Couldn't connect to Institution | 503 |