Status Codes

CategoryHTTP Status CodeCodeExplanation
2xx Success
OK
Everything worked as expected with content returned.
Accepted
1. Everything worked and MX’s system is processing the request. 2. When attempting an aggregation on a member, an aggregation of the same type is already running; e.g., calling aggregate member while a previous aggregation is still running, or calling verify member while a previous verification is still running.
No Content
Everything worked as expected without content returned.
4xx Requester error
Bad Request
Often, this means a required parameter was missing.
Unauthorized
Invalid MX-API-Key or MX-Client-ID provided.
Forbidden
The request was made from a non-whitelisted address or the feature is not available to the client.
Not Found
Invalid item/id/URL requested.
Method Not Allowed
A constraint on the requested endpoint wasn’t met.
Not Acceptable
The request didn’t specify a valid API version.
Conflict
1. An object with the given attributes already exists. 2. When attempting an aggregation on a member, the member already has an 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.
Unprocessable Identity
The data provided cannot be processed.
5xx Responder error — which are rare
Server errors
Something went wrong with MX’s servers.
Service unavailable
The MX Platform is being updated.