The SEDI API uses conventional HTTP response codes to indicate success or failure.

Error codes

Code	Meaning
400	Bad Request - invalid request body or parameters
401	Unauthorized - missing or invalid API key
403	Forbidden - the API key lacks the required permissions
404	Not Found - the resource does not exist
409	Conflict - resource already exists (e.g., duplicate email)
422	Unprocessable Entity - validation failed
429	Too Many Requests - rate limit exceeded
5xx	Server Error - something went wrong on our end

Error response format

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 45 seconds.",
    "status": 429
  }
}

Common issues

• 401 Unauthorized: Verify your API key is correct and has not expired
• 404 Not Found: Check the resource ID and ensure it belongs to your account
• 429 Too Many Requests: Implement exponential backoff using the Retry-After header