US Lottery API Documentation
Welcome to the official developer portal for the US Lottery API. Connect your mobile applications, web platforms, analytical tools, or sportsbooks to verified real-time lottery draw results, historical databases, jackpot estimates, and frequency analytics.
⚡ Quick Start Request
Send a request with your x-api-key header to retrieve winning numbers in seconds:
curl -X GET "https://uslotteryapi.com/api/v1/lotteries/latest?game=powerball" \
-H "x-api-key: YOUR_API_KEY" \
-H "Accept: application/json"Documentation Pillars
Getting Started Guide
Instructions on obtaining API keys, constructing HTTP request headers, and parsing response structures.
Authentication
Pass your x-api-key header in server-side requests and proxy environments safely.
Rate Limits & Quotas
Request quotas per plan (500 free requests/mo), rate limiting headers, and backoff handling.
Supported Games List
Complete catalog of 30+ national and state games (Powerball, Mega Millions, NY Lotto, Take 5, etc.).
API Endpoints Reference
All RESTful endpoints supported by US Lottery API v1.0 with parameter specs and response schemas.
/api/v1/lotteries/latest
Retrieve the most recent certified winning numbers, jackpot estimate, multiplier data, and draw timestamps for a specified game.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| game | string | Yes | Slug of the lottery game (e.g. powerball, mega-millions, ny-lotto, cash4life). |
curl -X GET "https://uslotteryapi.com/api/v1/lotteries/latest?game=powerball" \
-H "x-api-key: YOUR_API_KEY" \
-H "Accept: application/json"/api/v1/lotteries/analytics
Programmatically query 30-day ball frequencies, Hot & Cold numbers, sum distributions, top pairs, and Chi-Square randomness metrics across 50,000+ historical draws.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| game | string | Yes | Game identifier (e.g. powerball, mega-millions). |
| days | integer | No | Analysis period in days (default: 5, max: 365). |
curl -X GET "https://uslotteryapi.com/api/v1/lotteries/analytics?game=powerball&days=30" \
-H "x-api-key: YOUR_API_KEY" \
-H "Accept: application/json"/api/v1/states/[code]/games
Fetch state-specific lottery games and endpoint definitions for supported jurisdictions: New York (ny), California (ca), Florida (fl), Texas (tx), and Georgia (ga).
curl -X GET "https://uslotteryapi.com/api/v1/states/ny/games" \
-H "x-api-key: YOUR_API_KEY" \
-H "Accept: application/json"/api/v1/health
Check API service health, database connection, latency SLA, and active data ingestion worker status.
/api/v1/lotteries/check-ticket
Batch verify user tickets against official draw results. Calculates matching numbers, determines prize tiers, and applies multiplier options (e.g., Power Play, Megaplier).
JSON Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| game | string | Yes | Game identifier (e.g., powerball, mega-millions). |
| draw_date | string | Yes | The draw date in YYYY-MM-DD format. |
| tickets | array | Yes | Array of ticket objects containing numbers (array), bonus (optional int), and multiplier_played (optional bool). Maximum 100 tickets per request. |
curl -X POST "https://uslotteryapi.com/api/v1/lotteries/check-ticket" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"game": "powerball",
"draw_date": "2024-03-27",
"tickets": [
{
"numbers": [2, 14, 33, 38, 64],
"bonus": 1,
"multiplier_played": true
}
]
}'Frequently Asked Questions
How fast are lottery draw results updated in the API?
Winning numbers and official draw results are updated within 60 to 120 seconds after official certification.
Is there a free tier for US Lottery API?
Yes, our Starter Plan includes 500 free API requests per month with full access to Powerball, Mega Millions, and state lottery endpoints without requiring a credit card.
What format does the API return?
All US Lottery API endpoints return lightweight, ISO-compliant JSON responses formatted for high performance, featuring strict typing and standard Unix timestamps.