Errors
The MX Platform API uses conventional HTTP response codes to indicate the success or failure of a request, with supplementary error messaging as needed within response bodies.
Status Codes
| Status | Explanation |
|---|---|
| 200 OK | Everything worked as expected with content returned. |
| 202 Accepted | 1. Everything worked and MX’s system is processing the request. |
| 2. When attempting a job on a member, a job of the same type is already running; e.g., calling aggregate member while a standard agg is still running, or calling verify member while a previous verification is still running. | |
| 3. A standard aggregation has been attempted within the default minimum time between standard aggs. | |
| 204 No Content | Everything worked as expected without content returned. |
| 400 Bad Request | 1. A required parameter was missing. |
| 2. A premium aggregation-type job was requested, but the institution associated with the member does not support it. | |
| 401 Unauthorized | Invalid MX-API-Key or MX-Client-ID provided. |
| 403 Forbidden | The request was made from a non-whitelisted address or the feature is not available to the client. |
| 404 Not Found | Invalid item/id/URL requested. |
| 405 Method Not Allowed | A constraint on the requested endpoint wasn’t met. |
| 406 Not Acceptable | The request didn’t specify a valid API version. |
| 409 Conflict | 1. An object with the given attributes already exists. |
| 2. When attempting an aggregation on a member, the member already has an aggregation of a different type running; e.g., calling the verify endpoint while a standard aggregation is already running, or calling fetch statements while an identification aggregation is already running. | |
| 422 Unprocessable Entity | The data provided cannot be processed. |
| 429 Too Many Requests | This error is triggered when an IP address exceeds the maximum of 2000 concurrent connections, or the rate limit for requests per second on specific products and services is surpassed. To prevent this error, decrease the number of concurrent connections per IP or the number of requests per second. |
| 500, 502, 504 Server errors | Something went wrong with MX’s servers. |
| 503 Service Unavailable | The MX Platform is being updated. |