Errors
Error response format and error codes returned by the Terac API.
Error Format
All errors return a JSON object with code, message, and optional details:
{
"error": {
"code": "BAD_REQUEST",
"message": "Unknown filter slug: single_select--invalid",
"details": [
{
"field": "filters[0]",
"message": "Unknown filter slug"
}
]
}
}The details array is optional and provides field-level validation errors when available.
Error Codes
| HTTP Code | Error Code | Description |
|---|---|---|
| 400 | BAD_REQUEST | Invalid input (malformed filter slug, invalid screening question, missing required field) |
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 404 | NOT_FOUND | Resource not found or not accessible |
| 409 | CONFLICT | Action not allowed in current state (e.g., launching an already active opportunity) |
| 429 | RATE_LIMITED | Too many requests |
| 500 | INTERNAL_SERVER_ERROR | Unexpected server error |