Skip to content
USA LotteryResults API
Reference

Endpoints

All requests are GET over HTTPS to https://usa-lottery-result-all-state-api.p.rapidapi.com/ with your x-rapidapi-key and x-rapidapi-host headers. Every call counts as one request in your RapidAPI plan.

GET/lottery-results/states

State List

Every jurisdiction covered by the API, with its two-letter code, lottery tax rate and minimum legal playing age. Start here: stateCode is the key for State Game List.

no parameters

curl --request GET \
	--url 'https://usa-lottery-result-all-state-api.p.rapidapi.com/lottery-results/states' \
	--header 'x-rapidapi-host: usa-lottery-result-all-state-api.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Response fields
FieldTypeMeaning
statestringFull name, e.g. Florida
stateCodestringTwo-letter code, e.g. FL
slugstringURL-friendly name
taxRatestringState tax rate on lottery winnings, %
minimumLegalAgeintMinimum age to buy a ticket
1request
GET/lottery-results/states/game-list

State Game List

The games drawn in one state, with the rules you need to render a ticket: ball ranges, bonus balls, draw time and timezone, claim deadline and the states that share the draw. The id field is the gameID for every game endpoint.

ParameterTypeRequiredExampleNotes
statestringrequiredKSstateCode from State List
curl --request GET \
	--url 'https://usa-lottery-result-all-state-api.p.rapidapi.com/lottery-results/states/game-list?state=KS' \
	--header 'x-rapidapi-host: usa-lottery-result-all-state-api.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Response fields
FieldTypeMeaning
idintgameID for Drawing Result, Past Draws and the frequency endpoints
gameNamestringGame title
drawTime / drawTimezonestringLocal draw time and IANA timezone
minBall / maxBallintMain number range
bonusNumbersobject[]Powerball, Mega Ball, Cash Ball…
claimDeadlineintDays to claim a prize
statesWithMultiDrawsstring[]States that sell the same draw
1request
GET/lottery-results/game-result

Drawing Result

The result of one draw: winning and additional numbers, jackpot, cash payout, prize pools and winner counts, plus the game's full rule set. Leave drawID empty to get the latest draw.

ParameterTypeRequiredExampleNotes
gameIDintrequired24id from State Game List
drawIDintoptional–A draw from Past Draws. Empty = latest draw
curl --request GET \
	--url 'https://usa-lottery-result-all-state-api.p.rapidapi.com/lottery-results/game-result?gameID=24' \
	--header 'x-rapidapi-host: usa-lottery-result-all-state-api.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Response fields
FieldTypeMeaning
drawNumberintDraw number
drawDate / drawTimestringLocal date and time
drawTimestampintUnix time
winningNumbersint[]Main numbers
additionalNumbersint[]Bonus ball(s)
jackpot / cashPayoutstringAnnuity and cash value
overallWinnersintTotal winners this draw
gameDetailsobjectRules, state, draw days
1request
GET/lottery-results/main-draw

PowerBall & Mega Millions

The two national jackpot games with their recent draw list, without picking a state. Use it for a jackpot widget.

no parameters

curl --request GET \
	--url 'https://usa-lottery-result-all-state-api.p.rapidapi.com/lottery-results/main-draw' \
	--header 'x-rapidapi-host: usa-lottery-result-all-state-api.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Response fields
FieldTypeMeaning
gameDetailsobjectGame rules and draw days
draws[].drawNumberintDraw number
draws[].drawDatedateYYYY-MM-DD
draws[].drawTimestampintUnix time
1request
GET/lottery-results/past-draws-dates

Past Draws (Last 365 Days)

The dates and IDs of a game's draws over the last 365 days. Pass a drawID to Drawing Result to open any of them.

ParameterTypeRequiredExampleNotes
gameIDintrequired66id from State Game List
curl --request GET \
	--url 'https://usa-lottery-result-all-state-api.p.rapidapi.com/lottery-results/past-draws-dates?gameID=66' \
	--header 'x-rapidapi-host: usa-lottery-result-all-state-api.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Response fields
FieldTypeMeaning
gameDetailsobjectGame rules
draws[].drawIDintID for Drawing Result
draws[].drawNumberintDraw number
draws[].drawDatedateYYYY-MM-DD
1request
GET/lottery-results/most-frequent-numbers

Most Frequent Numbers

Hot numbers: the balls drawn most often in a game. Good for statistics pages and number pickers.

ParameterTypeRequiredExampleNotes
gameIDintrequired24id from State Game List
curl --request GET \
	--url 'https://usa-lottery-result-all-state-api.p.rapidapi.com/lottery-results/most-frequent-numbers?gameID=24' \
	--header 'x-rapidapi-host: usa-lottery-result-all-state-api.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Response fields
FieldTypeMeaning
numberintBall
countintTimes drawn
1request
GET/lottery-results/least-frequent-numbers

Least Frequent Numbers

Cold numbers: the balls drawn least often in a game.

ParameterTypeRequiredExampleNotes
gameIDintrequired24id from State Game List
curl --request GET \
	--url 'https://usa-lottery-result-all-state-api.p.rapidapi.com/lottery-results/least-frequent-numbers?gameID=24' \
	--header 'x-rapidapi-host: usa-lottery-result-all-state-api.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Response fields
FieldTypeMeaning
numberintBall
countintTimes drawn
1request
GET/lottery-results/old/game-list

Game List

Games in the historical dataset, which holds results up to 13 November 2023. Its gameID values differ from the other endpoints, so use them only with Historical Data Result.

no parameters

curl --request GET \
	--url 'https://usa-lottery-result-all-state-api.p.rapidapi.com/lottery-results/old/game-list' \
	--header 'x-rapidapi-host: usa-lottery-result-all-state-api.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Response fields
FieldTypeMeaning
idintHistorical gameID
namestringGame title
1request
GET/lottery-results/old/past-draws-dates

Historical Data Result

Results from the historical dataset (up to 13 November 2023). Pass a date for that day's draw; without a date the history comes back page by page. The website demo requires a date.

ParameterTypeRequiredExampleNotes
gameIDintrequired9id from Game List (historical)
datedateoptional2023-11-01YYYY-MM-DD. Empty = paginated history
curl --request GET \
	--url 'https://usa-lottery-result-all-state-api.p.rapidapi.com/lottery-results/old/past-draws-dates?gameID=9&date=2023-11-01' \
	--header 'x-rapidapi-host: usa-lottery-result-all-state-api.p.rapidapi.com' \
	--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'
Response fields
FieldTypeMeaning
drawDatedateYYYY-MM-DD
winningNumbersint[]Numbers drawn
1request