Data access API errors
The system uses HTTP status and error codes to indicate the success or failure of a request. For status codes other than 200, the HTTP response body will contain an error entity.
HTTP Status Codes | Meaning |
100s | Informational codes indicating that the request initiated by the browser is continuing. |
200s | Success codes returned when browser request was received, understood, and processed by the server. |
300s | Redirection codes returned when a new resource has been substituted for the requested resource. |
400s | Client error codes indicating that there was a problem with the request. |
500s | Server error codes indicating that the request was accepted, but that an error on the server prevented the fulfillment of the request. We recommend implementing three (3) retries to help your app deal with short-lived, transient failures. The waiting time between retries should increase exponentially with each retry attempt. |
Specific HTTP status and error codes may include:
HTTP Status Codes | Meaning |
403 | Access if forbidden. This may mean the route is incorrect. For example, if the version number is wrong. |
Error body
Data APIs support the ability to include debugging information with errors as defined in FDX 5.1 (RFC 01870). The debugMessage is not always present but will be included when possible.
element | type | description |
code | integer | Required. Error code returned as an integer rather than a string (as specified by FDX). The code is a long term persistent identifier which can be used to trace error conditions back to log information. |
message | string | Required. This message is consumer displayable information which may aid in diagnosis and error reporting. |
debugMessage | string | Not required. Message used to debug the root cause of the error. Contents should not be used in business logic. These messages may change at any time and should only be used for troubleshooting an issue. |
JSON
{
"code":701,
"message":"Account not found",
"debugMessage": "No accounts were found for this customer."
}Error codes
HTTP Status Code | FDX Error Code | Error Message | Description |
400 | 401 | Invalid input | Input sent by client does not satisfy API specification. |
400 | 702 | Invalid start or end date | Start or end date value is not in the ISO 8601 format. |
400 | 703 | Invalid date range | The start date is not earlier than the end date, or the date range is beyond what the system supports. |
401 | 602 | Customer not authorized | Authenticated customer does not have authorization to perform this action. Please attempt to refresh the token. See the Tokens overview. |
403 | 403 | Subscription not found | This error may be caused any of the following: 1. The providerId in your request is incorrect. 2. Your app isn’t subscribed to the requested provider. 3. Your app isn’t subscribed to the requested cluster. Please check the Data Recipient Hub to determine your subscription details. |
404 | 601 | Customer not found | Customer with ID not found. |
404 | 701 | Account not found | Account with ID not found. |
429 | 1207 | Too many requests | Too many requests were sent within a short period of time. |
500 | 500 | Internal server error | Catch-all exception for requests that were not processed due to a server originated outage/issue. |
500 | 501 | Subsystem unavailable | A system required to process the request was not available. Request was not processed |
503 | 503 | Scheduled Maintenance | The system is down for maintenance. |
Change log
Date | Update |
2025-Jan-02 | Initial publication |