Questions developers ask
Short answers. The docs have the details.
How do I buy access?
Through RapidAPI. Open the pricing page, pick a plan (Basic is free) and use the key RapidAPI gives you. Billing, invoices and plan changes are handled by RapidAPI.
Which games are covered?
All draw games sold in the 48 covered jurisdictions: multi-state games such as Powerball, Mega Millions, Lucky for Life, Cash4Life, Lotto America and 2by2, plus each state's own games such as Pick 2 to Pick 5, Cash Pop, Fantasy 5 and state lottos. Call State Game List for the exact list of a state.
How fast do results appear after a draw?
Results are added shortly after the state lottery publishes the official draw. Use each game's drawTime and drawTimezone to schedule your refresh a few minutes after the draw.
Which states are not included?
The feed lists 48 jurisdictions: 46 states plus the District of Columbia and Puerto Rico. Alaska, Hawaii, Nevada and Utah have no state lottery. Call State List for the live list.
How far back does the history go?
Past Draws covers the last 365 days. Older results, up to 13 November 2023, are in the historical endpoints.
What is the difference between gameID and drawID?
A gameID identifies a game in a state, for example Florida Powerball. A drawID identifies one draw of that game. Pass both to Drawing Result to open a past draw.
What happens when I use up my requests?
All plans have a hard limit, so you are never charged for extra requests. Calls are refused until your quota resets or you move to a larger plan on RapidAPI.
Can I call the API from JavaScript in the browser?
You can, but anyone could then read your RapidAPI key. Call the API from your server, cache the result and serve your own JSON to the browser. That is how the demo on this site works.
Is the website playground the real API?
Yes. It returns real data through this site's demo server. To keep it fair it caches responses, shortens long lists and limits the number of requests per visitor.
Are these official results?
The data mirrors the results published by the state lotteries, but it is informational. Winners must always confirm prizes with the official lottery before claiming.