Error Codes
A reference of standard HTTP status codes and custom error messages returned by the API.
HTTP Status Codes
The Emp-Mix API uses standard HTTP response codes to indicate the success or failure of an API request.
| Code | Status | Description |
|---|---|---|
| 200 | OK | The request was successful. |
| 400 | Bad Request | The request was unacceptable, often due to missing a required parameter or malformed JSON. |
| 401 | Unauthorized | No valid API key provided. Check your apiKey payload or x-api-key header. |
| 403 | Forbidden | The API key doesn't have permissions to perform the request (e.g., using a Public Key for a Secret Key endpoint). |
| 404 | Not Found | The requested resource doesn't exist. |
| 429 | Too Many Requests | Too many requests hit the API too quickly. Please implement exponential backoff. |
| 500, 502, 503, 504 | Server Errors | Something went wrong on Emp-Mix's end. (These are rare). |
Error Response Format
When an error occurs, the API will return a JSON response containing an error object with a human-readable message.
{
"error": {
"type": "invalid_request_error",
"message": "The 'distinct_id' parameter is required."
}
}