Overview
Pass a supported game identifier—powerball, megamillions, euromillions, or lottomax. The lookup returns the latest drawn numbers, game-specific bonus balls, draw date, and jackpot totals updated daily. EuroMillions draws include Lucky Stars, while Powerball and Mega Millions return their respective special balls. Paid plans can pass a past date for historical drawings, access upcoming draw estimates, and get frequency statistics over the 100 draws up to the returned one: the most and least drawn numbers, the most drawn bonus balls, and how often each number in the draw has come up.
Live Test Lottery Numbers API →
Endpoint
One host, one path per API. The block below shows this call in four languages; every one of them is the same HTTP request. Making requests covers the timeouts, retries and parameter rules that apply to all of them. The SDKs wrap the same call in a typed client.
curl "https://api.apiverve.com/v1/lottery?numbers=powerball&date=2024-01-15&stats=true" \
-H "x-api-key: your_api_key_here"const res = await fetch('https://api.apiverve.com/v1/lottery?numbers=powerball&date=2024-01-15&stats=true', {
headers: { 'x-api-key': 'your_api_key_here' },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data } = await res.json();
console.log(data);import requests
res = requests.get(
"https://api.apiverve.com/v1/lottery?numbers=powerball&date=2024-01-15&stats=true",
headers={"x-api-key": "your_api_key_here"},
timeout=15,
)
res.raise_for_status()
print(res.json()["data"])package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/lottery?numbers=powerball&date=2024-01-15&stats=true", nil)
req.Header.Set("x-api-key", "your_api_key_here")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}Replace your_api_key_here with the key from your dashboard. When the inputs arrive as a list rather than one at a time, batch requests run up to 200 of them through this same API in a single call.
Authentication
Send your key in the x-api-key header. That is the only auth step — there is no token exchange and no per-endpoint scope to configure. Authentication covers creating, rotating and revoking keys.
A 401 means the key is missing, invalid or expired. A 403 means the key is valid but not permitted here — blocked by a key restriction or an IP allow-list. Running out of credits is a 429.
Parameters
Sent in the query string. Premium parameters are accepted on every plan but only take effect on plans that include them.
| Parameter | Type | Description |
|---|---|---|
numbersRequired | string | The lottery game to lookup: powerball, megamillions, euromillions, or lottomaxpowerballmegamillionseuromillionslottomax |
dateOptionalPremium | string | Optional date for historical lookup (YYYY-MM-DD). Returns the nearest draw to this date. date |
statsOptionalPremium | boolean | Include number frequency statistics over the last 100 draws |
Response
Every API returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape. Response format covers the envelope, the other output formats and how premium fields are withheld.
{
"status": "ok",
"error": null,
"data": {
"drawDate": "2026-10-26",
"numbers": [
18,
26,
49,
50,
54,
1
],
"powerball": 1,
"jackpot": "$691 Million",
"jackpotValue": 691000000,
"jackpotFormatted": "$691 Million",
"lotteryType": "powerball",
"nextDraw": {
"drawDate": "2026-10-28",
"jackpot": "$716 Million",
"jackpotValue": 716000000,
"jackpotFormatted": "$716 Million",
"cashValue": "$307.2 Million",
"cashValueValue": 307200000
},
"stats": {
"drawsAnalyzed": 100,
"since": "2026-03-09",
"hotNumbers": [
{
"number": 42,
"timesDrawn": 13
},
{
"number": 3,
"timesDrawn": 12
},
{
"number": 64,
"timesDrawn": 12
},
{
"number": 4,
"timesDrawn": 11
},
{
"number": 14,
"timesDrawn": 11
}
],
"coldNumbers": [
{
"number": 1,
"timesDrawn": 3
},
{
"number": 34,
"timesDrawn": 3
},
{
"number": 39,
"timesDrawn": 3
},
{
"number": 62,
"timesDrawn": 3
},
{
"number": 20,
"timesDrawn": 4
}
],
"hotBonusNumbers": [
{
"number": 3,
"timesDrawn": 8
},
{
"number": 14,
"timesDrawn": 7
},
{
"number": 1,
"timesDrawn": 6
}
],
"drawNumbers": [
{
"number": 18,
"timesDrawn": 8,
"drawsSinceLast": 16
},
{
"number": 26,
"timesDrawn": 6,
"drawsSinceLast": 14
},
{
"number": 49,
"timesDrawn": 8,
"drawsSinceLast": 12
},
{
"number": 50,
"timesDrawn": 10,
"drawsSinceLast": 2
},
{
"number": 54,
"timesDrawn": 7,
"drawsSinceLast": 9
}
]
}
}
}
Response fields
Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.
| Field | Type | Example | Description |
|---|---|---|---|
drawDate | string | "2026-10-26" | Date of the drawing |
numbers | array | [18, ...] | Array of winning main numbers (for Powerball and Mega Millions, also includes the bonus ball as the final entry) |
powerball | number | 1 | The Powerball number drawn. Powerball only |
jackpot | string | "$691 Million" | Jackpot amount for this drawing |
jackpotValue | number | 691000000 | Jackpot amount for this drawing as a numeric value |
jackpotFormatted | string | "$691 Million" | Jackpot amount for this drawing, formatted as a currency string (same value as `jackpot`) |
lotteryType | string | "powerball" | Which lottery game this result is for: powerball, megamillions, euromillions, or lottomax |
nextDrawPremium | object | {...} | Estimated details for the upcoming, not-yet-drawn draw. Absent for a short window after each draw, while the operator recalculates the estimate |
drawDatePremium | string | "2026-10-28" | Date of the upcoming draw (best-effort; may be null when the source lists it only as a relative time) |
jackpotPremium | string | "$716 Million" | Estimated jackpot for the upcoming draw |
jackpotValuePremium | number | 716000000 | Estimated jackpot for the upcoming draw as a numeric value |
jackpotFormattedPremium | string | "$716 Million" | Jackpot amount for this drawing, formatted as a currency string (same value as `jackpot`) |
cashValuePremium | string | "$307.2 Million" | Estimated cash (lump-sum) value for the upcoming draw. Powerball and Mega Millions only |
cashValueValuePremium | number | 307200000 | Estimated cash value for the upcoming draw as a numeric value. Powerball and Mega Millions only |
statsPremium | object | {...} | Number frequency over the 100 draws up to and including the returned draw (null with too little history) (with stats=true) |
drawsAnalyzedPremium | number | 100 | Number of draws the statistics cover |
sincePremium | string | "2026-03-09" | Date of the oldest draw covered (YYYY-MM-DD) |
hotNumbersPremium | array[5] | The five main numbers drawn most often, with their counts | |
numberPremium | number | 42 | The number |
timesDrawnPremium | number | 13 | Times it was drawn in the covered draws |
coldNumbersPremium | array[5] | The five main numbers drawn least often, with their counts | |
numberPremium | number | 1 | The number |
timesDrawnPremium | number | 3 | Times it was drawn in the covered draws |
hotBonusNumbersPremium | array[3] | The three bonus balls (Powerball, Mega Ball or Lucky Star) drawn most often; null for Lotto Max | |
numberPremium | number | 3 | The bonus number |
timesDrawnPremium | number | 8 | Times it was drawn in the covered draws |
drawNumbersPremium | array[5] | Each main number of the returned draw with its frequency | |
numberPremium | number | 18 | The number |
timesDrawnPremium | number | 8 | Times it was drawn in the covered draws, including this one |
drawsSinceLastPremium | number | 16 | How many draws before this one it last came up (null if not in the covered draws) |
Errors
Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change. Error handling covers the full status list and which of them are worth retrying.
| Status | Meaning | What to do |
|---|---|---|
400 | Input was rejected | Read error; it names the parameter. |
401 | Key missing or invalid | Check the header name and the key value. |
403 | Key valid, but not permitted | A key restriction or IP allow-list; see key scoping. |
429 | Rate limited, or out of credits | Read error to tell them apart; see rate limits. |
Use cases
- Ticket Verification Portals
- Lottery tracking apps compare user-submitted ticket numbers against returned winning numbers and bonus balls to alert players to matching prizes.
- News Media Drawboards
- When a major draw concludes, regional news outlets display winning numbers and jackpot values on automated result widgets.
- Convenience Retail Displays
- Broadcast updated winning numbers and current jackpot totals on in-store digital screens to inform lottery customers at the checkout counter.
- Office Lottery Syndicates
- Pool managers verify group ticket entries against the latest draw dates and winning number arrays to automate weekly payout calculations.
Other ways to use Lottery Numbers
Set up Lottery Numbers on APIVerve, or reach the same source a different way. Your APIVerve account and credits work on all of them — one key, one balance.
Related
More in Data Lookup: