# Lottery Results (`lottery.results`)

Winning numbers for Powerball, Mega Millions and New York lottery games: the latest draw or any past draw by date or date range, newest first.

Docs: https://primaryapi.com/docs/api-reference/lottery/results

- Endpoint: `POST https://api.primaryapi.com/v1/run/lottery.results`
- Category: Knowledge & Data · Platform: `lottery` · Kind: list · Status: live
- Price: 1 credit per call. Every call costs the same, including calls that were retried automatically.
- Billing unit: per successful call
- Reliability: routed to a healthy upstream and retried automatically when an attempt fails; live 30-day status: `GET https://api.primaryapi.com/v1/status/apis?sku=lottery.results`
- Execution: synchronous (answers 202 only if it outlives the wait window)

## Input

| Field | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| `game` | enum | yes |  | one of: powerball, mega-millions, millionaire-for-life, ny-lotto, take5-evening, take5-midday, numbers-evening, numbers-midday, win4-evening, win4-midday, pick10, cash4life | Lottery game. One of: powerball, mega-millions, millionaire-for-life, ny-lotto, take5-evening, take5-midday, numbers-evening, numbers-midday, win4-evening, win4-midday, pick10, cash4life (see lottery.games). |
| `date` | string | no |  | pattern: ^\d{4}-\d{2}-\d{2}$ | Only the draw on this date (YYYY-MM-DD, New York date). Omit for the latest draws. |
| `dateFrom` | string | no |  | pattern: ^\d{4}-\d{2}-\d{2}$ | Only draws on or after this date (YYYY-MM-DD). |
| `dateTo` | string | no |  | pattern: ^\d{4}-\d{2}-\d{2}$ | Only draws on or before this date (YYYY-MM-DD). |
| `limit` | integer | no | 10 | 1–100 | Maximum number of results to return (1-100, default 10). |
| `cursor` | string | no |  |  | Opaque pagination cursor: pass the previous response's nextCursor. |

Unknown fields are rejected with `400 invalid_input`. The routing controls `preferLatencyUnderMs` and `maxCredits` may be sent in the same JSON body.

## Output

When `output.found` is `true`, `output.data` has this shape:

| Field | Type | Description |
|---|---|---|
| `game` | string |  |
| `gameName` | string |  |
| `draws` | object[] | Draws, newest first. |
| `draws[].game` | string | Game key, e.g. "powerball". |
| `draws[].drawDate` | string | Draw date (YYYY-MM-DD), the calendar date of the draw in New York. |
| `draws[].drawTime` | enum \| null | Which daily draw, for games drawn twice a day. |
| `draws[].numbers` | integer[] | Main winning numbers in the published order (digit games: each digit in order). |
| `draws[].specialBall` | integer \| null | Powerball, Mega Ball, Bonus, Cash Ball or Millionaire Ball; null when the game has none. |
| `draws[].specialBallName` | string \| null | Name of the special ball, e.g. "Powerball". |
| `draws[].multiplier` | integer \| null | Power Play or Megaplier drawn with the numbers; null when none was drawn. |
| `draws[].multiplierName` | string \| null |  |
| `draws[].doublePlay` | object \| null | Powerball Double Play draw, when one was held. |
| `draws[].doublePlay.numbers` | integer[] |  |
| `draws[].doublePlay.specialBall` | integer \| null |  |
| `nextCursor` | string \| null |  |

When the thing you asked about does not exist (or a search matches nothing) the call still succeeds: `output.found` is `false`, `output.data` is `null` and `output.reason` says why (`not_found`, `private`, `no_results`, …). Misses are free unless the notes below say misses are billed.

Pagination: pass the previous response’s `nextCursor` as `cursor` to get the next page; `nextCursor: null` means there are no more results.

## Example request

```bash
curl -sS -X POST "https://api.primaryapi.com/v1/run/lottery.results" \
  -H "Authorization: Bearer $PRIMARYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game":"powerball","limit":2}'
```

## Example response

_Values are placeholders that follow the output schema; `credits` is what this call would cost at the usual price._

```json
{
  "output": {
    "found": true,
    "data": {
      "game": "powerball",
      "gameName": "Powerball",
      "draws": [
        {
          "game": "powerball",
          "drawDate": "2026-11-14",
          "drawTime": "evening",
          "numbers": [
            9,
            44,
            49,
            51,
            68
          ],
          "specialBall": 4,
          "specialBallName": "Powerball",
          "multiplier": 2,
          "multiplierName": "Power Play",
          "doublePlay": {
            "numbers": [
              15,
              25,
              30,
              32,
              67
            ],
            "specialBall": 1
          }
        },
        {
          "game": "powerball",
          "drawDate": "2026-11-11",
          "drawTime": "evening",
          "numbers": [
            8,
            42,
            45,
            51,
            57
          ],
          "specialBall": 17,
          "specialBallName": "Powerball",
          "multiplier": 3,
          "multiplierName": "Power Play",
          "doublePlay": {
            "numbers": [
              15,
              27,
              45,
              52,
              55
            ],
            "specialBall": 1
          }
        }
      ],
      "nextCursor": "eyJvIjoyfQ"
    }
  },
  "provider": "PrimaryAPI",
  "credits": 1,
  "items": 2,
  "requestId": "req_01JBXK6Y2N9V8T4R3Q2P1M0A7Z",
  "nextCursor": null
}
```

## Pricing and reliability

- Usual price: 1 credit per call
- Price ceiling: the usual price, even when a call is retried. A quote’s `maxCredits` is the most a given call can cost; the `maxCredits` routing control caps it per call
- Live 30-day status, success rate, uptime and latency: `GET https://api.primaryapi.com/v1/status/apis?sku=lottery.results`

## Errors to handle

`invalid_input`, `unauthorized`, `insufficient_balance`, `key_limit_reached`, `trial_cap_reached`, `forbidden`, `not_found`, `idempotency_conflict`, `rate_limited`, `all_sources_failed`, `service_unavailable`, `timeout`. See https://primaryapi.com/docs/errors.

## Notes

Draws appear the morning after they are held (New York time), usually within a few hours; a monitor on {"game":"powerball","limit":1} fires once per new draw. A date with no draw returns found=false. Powerball and Mega Millions are national draws, so these are the same numbers every state publishes. Mega Millions has had no drawn multiplier since its April 2025 relaunch. Jackpot and prize amounts are not included.

## Legal

Results come from official state lottery open data; in a discrepancy, the lottery’s certified drawing results prevail. Always confirm numbers with the official lottery before acting on them. Informational only: no prize amounts, odds advice or ticket sales. Powerball and Mega Millions are trademarks of their owners.

