Back to Docs

Error Reference

Complete reference for all Seizn API error codes with resolution guides

Showing 8 of 8 error codes

Error Response Format

All Seizn API errors follow a consistent format with helpful debugging information:

{
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Invalid API key",
    "trace_id": "trc_abc123xyz",
    "request_id": "req_456def",
    "suggested_fix": "Check your API key in Dashboard...",
    "docs_url": "https://seizn.com/docs/api/authentication"
  }
}

Always include the trace_id when contacting support for faster resolution.

Authentication Errors

Errors related to API keys and authentication

AUTH_MISSING_KEYHTTP 401

Missing API Key

Suggested Fix: Add x-api-key header with your API key

AUTH_INVALID_KEYHTTP 401

Invalid API Key

Suggested Fix: Check your API key in Dashboard → API Keys

AUTH_EXPIRED_KEYHTTP 401

Expired API Key

Suggested Fix: Generate a new API key from the dashboard

Rate Limit Errors

Errors related to rate limiting and quotas

RATE_LIMITEDHTTP 429

Rate Limited

Suggested Fix: Implement exponential backoff (1s → 2s → 4s)

QUOTA_EXCEEDEDHTTP 429

Quota Exceeded

Suggested Fix: Upgrade your plan or wait for quota reset

Validation Errors

Errors related to invalid request format or data

INVALID_INPUTHTTP 400

Invalid Input

Suggested Fix: Check request body against API documentation

Resource Errors

Errors related to resources not found

NOT_FOUNDHTTP 404

Not Found

Suggested Fix: Verify the resource ID exists and is accessible

Server Errors

Unexpected server errors

INTERNAL_ERRORHTTP 500

Internal Error

Suggested Fix: Retry the request; contact support if it persists

Need More Help?

  • Include the trace_id in all support requests for faster debugging
  • Check status.seizn.com for service status and planned maintenance
  • Retry with exponential backoff for rate limit and external service errors
  • Contact support at [email protected] for persistent issues