Errors
Errors use one JSON envelope.
All API errors return an error object with a stable code and human-readable message.
Shape
{
"error": {
"code": "validation_error",
"message": "limit must be 5000 or less",
"request_id": "optional-request-id"
}
}
Common statuses
| Status | Code | Meaning |
|---|---|---|
400 | validation_error | A query parameter or host value is invalid. |
401 | missing_auth or bad_auth | The API key is missing or invalid. |
403 | forbidden | The API key exists but is not assigned to the required API group. |
404 | not_found | The requested host was not found in the selected window. |
405 | method_not_allowed | The endpoint does not support that HTTP method. |
500 | internal_error | The API could not complete the request. |