Akoya 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. |
FDX exception
Akoya error codes are consistent with FDX API 4.1 standards with the following exception:
The error code is returned as an integer rather than a string. See the example error body below.
Error body
codeFDX error code as an integermessageDescription of the error
{
"code":702,
"message":"Invalid start or end date"
}
| 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 | Customer does not have authorization to perform this action. The customer may have revoked access through provider and would need to reauthenticate. |
| 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 Akoya product. Please check the Akoya Hub to determine your subscription details. |
| 404 | 601 | Customer not found | Customer with ID not found. Token may have been revoked. |
| 404 | 701 | Account not found | Account with ID not found. |
| 422 | 704 | Account type not supported | Request made for investment, loans, taxes, statements and other functions that we currently do not support. Error also covers certain account types that are not supported, such as if an account doesn’t support payment-networks. |
| 500 | 500 | Internal server error | Catch-all exception for requests that were not processed due to an Akoya-originated outage/issue. |
| 500 | 501 | Subsystem unavailable | Catch-all exception for requests that were not processed due to a Data Provider-originated outage/issue. |
Change log
| Date | Update |
|---|---|
| 2022-Oct-21 | Updated description for FDX 704/HTTP 422 error |
| 2022‑Mar‑2 | Added error 704 to support payment-networks error |
| 2023-Jan-8 | Added definition for error 403 - subscription not found |