# Sportinglife (httpswww.sportinglife) — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Access detailed horse racing information from Sporting Life, including complete racecards organized by date and comprehensive runner details for specific races. Plan your betting strategy with up-to-date race listings and individual horse performance data all in one place.

**Category:** Sports | **Website:** [httpswww.sportinglife/](https://httpswww.sportinglife/) | **Docs:** [parse.bot/marketplace/420507e2-1ff6-43f1-b193-fedf2a91ee94/httpssportinglife-api](https://parse.bot/marketplace/420507e2-1ff6-43f1-b193-fedf2a91ee94/httpssportinglife-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/sporting-life/`
**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 race detail

Returns comprehensive racecard data for a single race including full runner details. Each runner includes horse name, trainer, jockey, weight, draw, official rating, forecast odds, spotlight commentary, form, headgear, and lifetime statistics. The race_id is obtained from the get_racecards endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `race_id` | string | Yes | Numeric race identifier from get_racecards results (e.g. 934439). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/sporting-life/get-race-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"race_id":"<string>"}'
```

### Get meetings

List all UK and Irish horse racing meetings and their race schedules for a given date. Returns meeting venue details, going conditions, and an array of races with basic metadata (time, name, class, distance, runner count). Use the returned race_id values with the get_racecard endpoint to fetch detailed runner information. Makes one upstream request per call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Race date in ISO format YYYY-MM-DD (e.g. 2026-08-20). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/sporting-life/get-meetings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### Get racecard

Get the detailed racecard for a specific race, including meeting context, race conditions, and a full array of runners. Each runner includes: horse name, age, cloth number, draw, weight, jockey, trainer, odds, official rating, form figures, last run date, last run days since, previous race class, Timeform commentary/analysis, headgear, and Timeform star rating. Requires a race_id obtained from the get_meetings endpoint. Makes two upstream requests per call (one to locate the race, one to fetch its detail page).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Race date in ISO format YYYY-MM-DD (e.g. 2026-08-20). |
| `race_id` | string | Yes | Numeric race identifier obtained from get_meetings response (e.g. 934024). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/sporting-life/get-racecard \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","race_id":"<string>"}'
```

### Get racecards

Returns all UK and Irish racecards for a given date. Each race includes meeting venue, going, surface, race time, race name, distance, class, and a full list of runners with horse name, trainer, jockey, odds, weight, draw, and official rating. Makes one request per race to fetch full runner details, so response time scales with the number of races on the card (typically 20-30 races per day).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Race date in ISO format YYYY-MM-DD (e.g. 2026-08-18). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/sporting-life/get-racecards \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

## Next steps

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