Core Resources
Banking Api
Energy Api
Common api
Fiskil uses conventional HTTP response codes to indicate the success or failure of an API request. Codes in the 2xx range indicate success. Codes in the 4xx range indicate an issue with request parameters. Codes in the 5xx range indicate an error with Fiskil's servers.
In case of 4xx or 5xx errors, Fiskil returns an error response object with the following attributes.
It is a unique id associated with an error. Fiskil uses it to debug issues in servers. Clients can send it to us in case of 5xx errors.
A short description of this error. This should be stable across multiple occurrences of this type of error and typically expands on the reason for the status code.
A detailed description of this error. This should be considered unique to individual occurrences of an error and subject to change. It is useful for debugging purposes.
However, note that the direct requests to data holders (with cdr in the request URL) will follow the error response convention as per CDR guidelines.
A list of all Consent lifecycle related errors, i.e. during consent creation
This error is returned by our API in the event of a remote institutions failure during consent creation by an end-user within the data holder’s web application.
https://cancel_uri?error=server_error&error_id=err_acde070d-8c4c-4f0d-9d8a-162843c10333&error_type=CONSENT_UPSTREAM_PROCESSING_ERROR&error_description=Unknown upstream server error whileprocessing consent flow inside third-party data-holder&error_uri=https://data.docs.fiskil.dev/errors#CONSENT_UPSTREAM_PROCESSING_ERROR
This error is returned by the API in the event of a the end-user aborting a consent creation flow within the remote institution consent authorisation.
https://cancel_uri?error=access_denied&error_id=err_acde070d-8c4c-4f0d-9d8a-162843c10333&error_type=CONSENT_ENDUSER_DENIED&error_description=End-user denied consent during consent creation inside third-party data-holder application&error_uri=https://data.docs.fiskil.dev/errors#CONSENT_ENDUSER_DENIED
This error is returned by the API in the event of a the end-user experiencing OTP authorization failure during a consent creation flow within the remote institution consent process.
https://cancel_uri?error=access_denied&error_id=err_acde070d-8c4c-4f0d-9d8a-162843c10333&error_type=CONSENT_OTP_FAILURE&error_description=End-user did not enter valid OTP during authentication inside third-party data-holder appl&error_uri=https://data.docs.fiskil.dev/errors#CONSENT_OTP_FAILURE
This error is returned by the API in the event of an authorised end-user experiencing failure to select a valid remote institution account during a consent authorisation.
https://cancel_uri?error=access_denied&error_id=err_acde070d-8c4c-4f0d-9d8a-162843c10333&error_type=CONSENT_ENDUSER_INELIGIBLE&error_description=End-user not eligible for account(s) and/or unable to create consent inside third-party da&error_uri=https://data.docs.fiskil.dev/errors#CONSENT_ENDUSER_INELIGIBLE
This error is returned by the API in the event of an authorised end-user failing to complete a consent flow before the data holder’s web application experiences a timeout. Reasons include leaving the web application open for too long, or closing the browser window before completing the flow
https://cancel_uri?error=access_denied&error_id=err_acde070d-8c4c-4f0d-9d8a-162843c10333&error_type=CONSENT_TIMEOUT&error_description=End-user timed out during consent creation inside third-party data-holder application. End&error_uri=https://data.docs.fiskil.dev/errors#CONSENT_TIMEOUT
This error is returned by the API in the event of a processing error by Fiskil, not related to an upstream data holder. This error is raised by Fiskil.
Was this page helpful?