Statuses and Error Messages

Learn about status and error messages for diffent Nordigen endpoints.

Statuses

Learn more about each state for requisitions and accounts.

requistions endpoint

Status shortStatus longDescription
CRCREATEDRequisition has been succesfully created
LNLINKEDAccount has been succesfully linked to requisition

accounts endpoint

Status longDescription
DISCOVEREDUser has succesfully authenticated herself, and account has been discovered
PROCESSINGAccount is being processed by the ASPSP
READYAccount has been successfully processed
ERRORAn error was encountered when processing account
SUSPENDEDAccount has been suspended (more than 10 attempts to access account when in ERROR status)

 

Error Messages

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

SummaryDetailHTTP status
Unknown fields {fields} in the payload 400
 Invalid token401

agreements endpoint

SummaryDetailHTTP status
Incorrect max_historical_daysmax_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 AgreementCannot delete accepted End User Agreement: {eua_id}. Only non accepted agreements can be deleted400
 Invalid token401

requisitions endpoint

SummaryDetailHTTP status
Invalid redirect URIRedirect 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 one400
Incorrect enduser_idenduser_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 language400
 Invalid token401

 

accounts endpoint

SummaryDetailHTTP status
Account state does not permit accessing {trx\|balances\|details}Try re-connect account400
Account exists but there is no valid enduser agreement permitting you to access it 400
Invalid Account ID{id} is not a valid UUID400
Account suspendedThis Account or its Requisition was suspended due to numerous errors that occurred while accessing it409
Couldn't update account {balances\|details\|transactions}Request limit exceeded For every authenticated end user, you can update data 4 times per day429
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 unavailable503
 Invalid token401