API documentation
Error Handling
Errors use stable codes so customer integrations can handle auth, rate-limit, validation, and upstream freshness cases.
Section
27 / 27
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
Live API examples
Jump from the docs to real public pages that use the same read models.
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.
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.