Errors

The exit1.dev API uses standard HTTP status codes and returns structured error responses.

Status Codes

Error Response Format

All error responses follow this structure:

{
  "error": {
    "code": 400,
    "message": "Invalid parameter: limit must be between 1 and 100"
  }
}

Common Errors

401 Unauthorized

{
  "error": {
    "code": 401,
    "message": "Invalid or missing API key"
  }
}

Causes:

• Missing X-Api-Key header
• Invalid API key format
• Revoked API key

403 Forbidden

{
  "error": {
    "code": 403,
    "message": "Access denied"
  }
}

Causes:

• Invalid permissions for the requested resource
• API key does not have access to the requested check

404 Not Found

{
  "error": {
    "code": 404,
    "message": "Check not found"
  }
}

Causes:

• The check ID does not exist
• The check belongs to a different account

429 Too Many Requests

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please retry after the reset time.",
    "retryAfter": 60
  }
}

Cause: You’ve exceeded a rate limit. Wait for the specified retry period.