Get Lottery Schedules
Returns compact draw schedules for customer-visible lotteries with date-aware timezone and day-rule context.
Section
21 / 27
Live API examples
Jump from the docs to real public pages that use the same read models.
Endpoints
/v1/schedulesCustomer-visible draw schedules with optional date context.
Request
Use schedule filters when an integration needs draw-window context. The optional date supplies timezone and day-of-week context.
GET https://api.lotteryfeedapi.com/v1/schedules?state=TN&date=2026-06-21&ball_count=3
Response
Rows include local time, UTC time, timezone ID, day rules, next_draw polling context, source evidence when available, compact latest_draw confidence/provenance when a visible result exists, and a date_context status when the schedule text can be normalized safely. Use unknown as an informational state rather than a hard polling decision.
{
"generated_at": "2026-06-21T12:00:00Z",
"filters": { "state": "TN", "date": "2026-06-21", "ball_count": "3" },
"count": 1,
"data": [
{
"game_code": "tn-pick3-evening",
"name": "Tennessee Cash 3 Evening",
"state": "Tennessee",
"state_code": "TN",
"ball_count": 3,
"links": {
"canonical": "/lotteries/tn-pick3-evening",
"latest_result": "/lotteries/tn-pick3-evening",
"api": "/v1/lotteries/tn-pick3-evening",
"api_docs": "/api-docs/schedules",
"api_integration": "/lotteries/tn-pick3-evening/api-integration",
"schedule_api": "/v1/schedules?game_code=tn-pick3-evening&date=2026-06-21",
"schedule_docs": "/api-docs/schedules"
},
"draw_schedule": {
"local_time": "6:28 PM CDT",
"utc_time": "23:28 UTC",
"days": "Every day",
"description": "Every day. On Sunday, only the evening draw runs.",
"timezone": "America/Chicago",
"next_draw": {
"date": "2026-06-21",
"local_time": "6:28 PM CDT",
"utc_time": "23:28 UTC",
"local_datetime": "2026-06-21T18:28:00",
"utc_datetime": "2026-06-21T23:28:00Z",
"timezone": "America/Chicago",
"days_until": 0,
"polling_window": {
"first_check_after_utc": "2026-06-21T23:38:00Z",
"retry_until_utc": "2026-06-22T01:28:00Z",
"first_check_delay_minutes": 10,
"retry_window_minutes": 120,
"label": "Start result checks at 2026-06-21T23:38:00Z; keep retries bounded until 2026-06-22T01:28:00Z unless your plan or source policy says otherwise."
},
"label": "Next scheduled draw on Sunday, June 21, 2026 at 6:28 PM CDT (23:28 UTC)."
},
"note": "On Sunday, only the evening draw runs.",
"source": {
"label": "Tennessee Lottery Cash 3 rules",
"url": "https://tnlottery.com/games/how-to-play/cash3/"
}
},
"next_draw": {
"date": "2026-06-21",
"local_time": "6:28 PM CDT",
"utc_time": "23:28 UTC",
"local_datetime": "2026-06-21T18:28:00",
"utc_datetime": "2026-06-21T23:28:00Z",
"timezone": "America/Chicago",
"days_until": 0,
"polling_window": {
"first_check_after_utc": "2026-06-21T23:38:00Z",
"retry_until_utc": "2026-06-22T01:28:00Z",
"first_check_delay_minutes": 10,
"retry_window_minutes": 120,
"label": "Start result checks at 2026-06-21T23:38:00Z; keep retries bounded until 2026-06-22T01:28:00Z unless your plan or source policy says otherwise."
},
"label": "Next scheduled draw on Sunday, June 21, 2026 at 6:28 PM CDT (23:28 UTC)."
},
"date_context": {
"date": "2026-06-21",
"status": "scheduled",
"label": "Scheduled on Sunday. Every day. On Sunday, only the evening draw runs."
},
"latest_draw": {
"draw_date": "2026-06-20",
"status": "official",
"source_confidence": {
"level": "official",
"label": "Official source",
"policy": "Numbers were published from the official or canonical lottery source path."
},
"provenance": {
"label": "Tennessee Lottery",
"role": "official",
"provider": "Tennessee Lottery",
"display": "Tennessee Lottery published this result."
}
}
}
]
}Request timing window
Use schedules to limit requests to games whose draw window is relevant for a selected date and jurisdiction. next_draw gives a local draw date, UTC datetime, and polling_window for planning bounded checks after the draw. Schedules are metadata, not proof that a result has already been published.
Timezone and daylight saving
Store the timezone ID alongside local and UTC labels. Offsets can change during daylight saving transitions, so clients should not persist only the current offset. When date is supplied, the response uses that date as the schedule context for UTC conversion and weekday labels where the source data can be normalized safely.
Stored schedule metadata
The schedule endpoint returns bounded customer-facing catalog metadata. Use result endpoints to determine whether a draw has been published.
API documentation FAQ
Short answers for teams using get lottery schedules in production integrations.
Does a schedule row prove that a result is published?
No. A schedule describes an expected draw window. Use the latest-result or history endpoint to check result availability.
How should I handle daylight saving time?
Persist the timezone field such as America/Chicago or America/New_York and recompute future local/UTC conversions with a timezone-aware library. Do not store only the visible CDT, EST, or UTC offset.
Can date_context decide whether to poll?
Use date_context as a scheduling hint. scheduled means the normalized public day rule matches the date, not_scheduled means it probably does not, and unknown means the text is not normalized enough for a hard decision.
Next: Draw years