# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/powerball/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/powerball/get-all-games \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/powerball/get-draw-result-by-date \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/powerball/get-jackpot-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/powerball/get-latest-powerball-drawing \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/powerball/get-previous-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/powerball/get-prizes-and-odds \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/powerball/get-winners-gallery \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.