Statuses and Error Messages

Learn about status and error messages for different Nordigen endpoints.

Statuses

Learn more about each state for requisitions and accounts.

Requisitions endpoint

Status shortStatus longDescriptionStage*
CRCREATEDRequisition has been successfully created1
GCGIVING_CONSENTEnd-user is giving consent at Nordigen's consent screen2
UAUNDERGOING_AUTHENTICATIONEnd-user is redirected to the financial institution for authentication3
RJREJECTEDEither SSN verification has failed or end-user has entered incorrect credentials4
SASELECTING_ACCOUNTSEnd-user is selecting accounts5
GAGRANTING_ACCESSEnd-user is granting access to their account information6
LNLINKEDAccount has been successfully linked to requisition7
SUSUSPENDEDRequisition is suspended due to numerous consecutive errors that happened while accessing its accounts8
EXEXPIREDAccess to accounts has expired as set in End User Agreement9

*describes sequence for each possible status, where “1” is starting status.

 

Accounts endpoint

Status longDescription
DISCOVEREDUser has successfully authenticated herself, and account has been discovered
ERRORAn error was encountered when processing account
EXPIREDAccess to account has expired as set in End User Agreement
PROCESSINGAccount is being processed by the institution
READY    Account has been successfully processed
SUSPENDEDAccount has been suspended (more than 10 consecutive failed attempts to access the account)

End user authentication messages

STATUSDESCRIPTIONHTTP status
InstitutionTechnicalErrorA technical error occurred while trying to connect to the institution, please try again.500
NordigenTechnicalErrorAn unexpected error occurred in the Nordigen system. If this error persists, please contact support.500
UserCancelledSessionUser cancelled the session.401
UserSessionRejectedUser session rejected due to incorrect credentials or a business exception.401
UnknownErrorAn unknown error occurred. 

API Messages

All error HTTP codes will 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 institution ID",
        "detail": "Get institution ID from /institutions/?country={country_code}",
        "status_code": 400
}

Institutions 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 <= {institution_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
Invalid Account ID{id} is not a valid UUID400
End User Agreement (EUA) {eua_id} has expiredEUA 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 Requisition400
AccessExpiredErrorAccess has expired or it has been revoked. To restore access reconnect the account401
AccountInactiveErrorAccount has been deactivated or it no longer exists401
Invalid token        401
AccountAccessForbiddenAccess to account is forbidden, the user might not have the necessary permissions403
Account suspendedThis Account or its Requisition was suspended due to numerous errors that occurred while accessing it409
RateLimitErrorDaily request limit set by the Institution has been exceeded429
UnknownRequestErrorRequest to institution returned unknown error500
ServiceErrorInstitution service unavailable503
ConnectionErrorCouldn't connect to Institution503