Error Codes

Reference for API error codes and how to handle them.

Error Response Format

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": { ... }  // Optional additional info
  }
}

Error Codes

Code	HTTP	Description
`INVALID_API_KEY`	401	API key missing or invalid
`EXPIRED_API_KEY`	401	API key has expired
`FORBIDDEN`	403	Missing permission or access denied
`NOT_FOUND`	404	Resource not found
`VALIDATION_ERROR`	422	Invalid request data
`RATE_LIMITED`	429	Rate limit exceeded
`INTERNAL_ERROR`	500	Server error