Lotteries API
The core Lotteries API provides access to the master games catalog, global system statistics, and comprehensive queries for both the absolute latest draw results and paginated historical data.
Authentication
All endpoints below require an active x-api-key header.
1. Master Games Catalog
Returns the catalog of all lottery games across the entire system with optional filtering.
/api/v1/lotteries/gamesQuery Parameters
| Parameter | Type | Description |
|---|---|---|
| category | string | Filter by game category (e.g., national, state). |
| state | string | Filter by state code (e.g., NY). |
| status | string | Filter by status (e.g., active, inactive). |
curl -X GET "https://uslotteryapi.com/api/v1/lotteries/games?status=active" \
-H "x-api-key: YOUR_API_KEY_HERE"2. System Statistics
Provides an overview of the entire lottery database, including total draw records, supported states, and a breakdown per game type.
/api/v1/lotteries/stats3. Get All Latest Results
A high-performance endpoint returning the absolute most recent draw result for ALL supported lottery games in a single request payload.
/api/v1/lotteries/latestcurl -X GET "https://uslotteryapi.com/api/v1/lotteries/latest" \
-H "x-api-key: YOUR_API_KEY_HERE"4. Search & Filter Draw History
Paginated endpoint to query the historical draw results database.
/api/v1/lotteriesQuery Parameters
| Parameter | Type | Description |
|---|---|---|
| type | string | Filter by any game slug from the Master Catalog (e.g., powerball, fl-pick3, ca-fantasy5). Use GET /api/v1/lotteries/games to see all available slugs. |
| from | string | Start draw date in format YYYY-MM-DD. |
| to | string | End draw date in format YYYY-MM-DD. |
| page | number | Page number for pagination. Default: 1. |
| page_size | number | Results per page (max 100). Default: 20. |
| latest | boolean | If true, returns only the absolute latest result matching the criteria. |
curl -X GET "https://uslotteryapi.com/api/v1/lotteries?type=powerball&from=2026-01-01&page_size=5" \
-H "x-api-key: YOUR_API_KEY_HERE"5. Quick Results By Type
A shortcut endpoint for fetching the most recent N draws for any game type in the Master Catalog — supports all 224+ lottery games across 49 states.
/api/v1/lotteries/[type]Path Parameters
| Parameter | Type | Description |
|---|---|---|
| type | string | Any valid game slug from the Master Catalog. Use GET /api/v1/lotteries/games to discover all available slugs. Returns 404 if the game is not found. |
| limit | number | Number of most recent draws to return (1–50). Default: 10. |
Examples:
National: /api/v1/lotteries/powerball?limit=10
State (FL): /api/v1/lotteries/fl-pick3?limit=5
State (CA): /api/v1/lotteries/ca-fantasy5?limit=3