Skip to content
Lottery Feed API

Lottery Feed API

ResultsPersonalAPI DocsPricingContact
Sign inJoin the Free Beta
  1. Home
  2. /
  3. API docs
  4. /

  5. Error Handling

API documentation

Error Handling

Errors use stable codes so customer integrations can handle auth, rate-limit, validation, and upstream freshness cases.

Browse guidesOpenAPI JSON
On this page
Error payloadCommon status codes

Error payload

Every error returns a machine-readable code and a short human message. Rate-limit errors also include error.rate_limit so clients can pause one key, surface the reset time, and avoid aggressive retries.

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Daily API key request limit has been reached.",
    "rate_limit": {
      "scope": "api_key",
      "window": "utc_day",
      "limit": 3000,
      "used": 3000,
      "remaining": 0,
      "reset_at": "2026-05-27T00:00:00.000Z",
      "retry_after_seconds": 3600,
      "hint": "Pause this API key until reset_at or raise the key daily limit in account API key settings."
    }
  }
}

Common status codes

Use 400 for validation, 401 for missing/invalid credentials, 403 for scope/plan mismatch, 404 for unknown lottery or draw, 429 for rate limits, and 503 for temporary feed freshness issues.

01Introduction02Quickstart03Polling and integration04Sandbox fixtures05SDK starter06Embeddable widgets07API playground08OpenAPI spec09Postman collection10API changelog11Authentication12API key scopes13Freshness levels14Source confidence15Status monitoring16Rate limiting17Get countries18Get states19Get lotteries20Get lottery21Get schedules22Draw years23Lottery results24History export25Number frequency26Result checker27Error handling

Related resources

Explore guides, examples and tools for your integration.

Latest results browserSee the compact public result model with filters and draw dates.
Lottery catalogFind game names, states, ball counts, latest numbers, and API guides.
Maryland Pick 3 API guideOpen a concrete endpoint example using the same game shown in snippets.
Pricing and limitsCompare freshness targets, request limits, and integration features.
Customer integration centerSign in to check API keys, usage, webhook delivery, plan limits, and the next recommended action.
OpenAPI contractUse the machine-readable contract for code generation and integration tests.
Lottery Feed API

Normalized lottery draw results, history, schedules, source-confidence metadata, and descriptive analytics for integrations and personal analysis.

Independent software and data service. We do not sell lottery tickets, accept bets or player funds, operate draws, determine outcomes or pay prizes.Lottery names and trademarks belong to their respective owners. Lottery Feed API is an independent data service and is not affiliated with, endorsed by, sponsored by or operated by any lottery authority.
LotteriesDaily ArchiveCountriesStatesStatusResponsible UseAcceptable UseReport incorrect resultCompanyTermsPrivacyAccount