# Powerball — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Check the latest Powerball drawing results, historical winning numbers, current jackpot amounts, and prize information all in one place. Browse past draws by date, view odds and prize breakdowns, and explore stories from winners to stay informed about your favorite lottery game.

**Category:** Other | **Website:** [powerball.com/](https://powerball.com/) | **Docs:** [parse.bot/marketplace/d13996d5-035d-4c03-b71c-57f35c3bc4f1/powerball-com-api](https://parse.bot/marketplace/d13996d5-035d-4c03-b71c-57f35c3bc4f1/powerball-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-powerball-com-api-d13996d5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_games

List all available lottery games with their names and codes. Returns a static list of supported games that can be used as game_code parameter in other endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-powerball-com-api-d13996d5/get_all_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_draw_result_by_date

Fetch a specific draw result for any game by date. Returns winning numbers, jackpot info, multiplier, and winners breakdown for the specified drawing. If date is omitted, returns the most recent drawing for the game.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date of the drawing in YYYY-MM-DD format. Omitting returns the most recent drawing for the game. |
| `game_code` | string | No | Game code identifying which lottery game to query. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-powerball-com-api-d13996d5/get_draw_result_by_date \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","game_code":"<string>"}'
```

### get_jackpot_info

Get current jackpot information for all major games including estimated jackpot amount and cash value. Makes one request per game to collect the latest jackpot figures.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-powerball-com-api-d13996d5/get_jackpot_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_latest_powerball_drawing

Retrieve the most recent Powerball drawing result including winning numbers, jackpot amount, cash value, multiplier, and winners breakdown by prize tier. Always returns the latest available drawing without any parameters.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-powerball-com-api-d13996d5/get_latest_powerball_drawing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_previous_results

Retrieve historical drawing results for any game within a date range. Returns an array of past drawings with winning numbers and multipliers. Date parameters use MM/DD/YYYY format. Omitting dates returns the default range of recent results (approximately 30 drawings).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_date` | string | No | End date in MM/DD/YYYY format. Omitting returns results up to the most recent drawing. |
| `game_code` | string | No | Game code identifying which lottery game to query. |
| `start_date` | string | No | Start date in MM/DD/YYYY format. Omitting returns the default range of recent results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-powerball-com-api-d13996d5/get_previous_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_date":"<string>","game_code":"<string>","start_date":"<string>"}'
```

### get_prizes_and_odds

Retrieve the Powerball prize chart with Power Play multiplier values and the odds chart for each prize tier. The prize chart shows base prizes and all Power Play multiplier columns (2x through 10x). The odds chart shows the probability of each match tier.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-powerball-com-api-d13996d5/get_prizes_and_odds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_winners_gallery

Fetch winner stories from the Powerball winners gallery. Returns state names and associated images for each winner entry. Paginated by page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-powerball-com-api-d13996d5/get_winners_gallery \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```