Error Codes
A reference of standard HTTP status codes and custom error messages returned by the API.
HTTP Status Codes
The Solvof 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 Solvof'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."
}
}