# Results Usatf — 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.

> Access meet information, competition schedules, and event results from USATF track and field competitions. Look up athlete profiles, browse daily schedules, and retrieve detailed results from meets including para nationals events.

**Category:** Sports | **Website:** [results.usatf.org/](https://results.usatf.org/) | **Docs:** [parse.bot/marketplace/33541413-3ab6-480b-b30d-37db457780c4/results-usatf-org-api](https://parse.bot/marketplace/33541413-3ab6-480b-b30d-37db457780c4/results-usatf-org-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/results-usatf/`
**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 athlete profile

Returns the full biography and competition history for an athlete from the World Athletics (IAAF) database. Only works for athletes with IAAF profiles; para-only athletes may return upstream_error. The meet_id provides the context for looking up the athlete's entry.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `athlete_id` | string | Yes | Athlete ID, obtainable from get_event_results ED entries (e.g. '393286'). |
| `meet_id` | string | No | Meet ID identifying the competition context for the athlete lookup. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/results-usatf/get-athlete-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"athlete_id":"<string>","meet_id":"<string>"}'
```

### Get competition info

Returns top-level metadata about a specific USATF competition including name, location, facility, dates, and configuration. Returns upstream_error for unknown meet IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `meet_id` | string | No | Meet ID identifying the competition. Known values: '8035' (2025 Toyota USATF Outdoor Championships), '8036' (2025 Para Nationals). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/results-usatf/get-competition-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"meet_id":"<string>"}'
```

### Get event results

Returns detailed results and athlete entry list for a specific event. The ED field contains athlete entries keyed by entry ID, each with athlete info (A), marks (M), placement (P), and team (TN). Returns stale_input if the event key is not found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_key` | string | Yes | Event key from the schedule, in format 'EN-R' where EN is the event number and R is the round number (e.g. '22-1', '3-1', '144-1'). Obtain from get_schedule_by_day results. |
| `meet_id` | string | No | Meet ID identifying the competition. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/results-usatf/get-event-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"event_key":"<string>","meet_id":"<string>"}'
```

### Get para nationals schedule by day

Returns the event schedule for a USATF Para Nationals meet, optionally filtered by date. Returns an empty events array for dates outside the meet window. Structure is identical to get_schedule_by_day.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date to filter events by, in ISO format YYYY-MM-DD (e.g. '2025-08-02'). Omitting returns all Para Nationals events. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/results-usatf/get-para-nationals-schedule-by-day \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>"}'
```

### Get schedule by day

Returns the event schedule for a given meet, optionally filtered by date. Each event includes name, round, start time, status, and event key. Returns an empty events array for dates with no scheduled events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date to filter events by, in ISO format YYYY-MM-DD (e.g. '2025-08-02'). Omitting returns all events across all days. |
| `meet_id` | string | No | Meet ID identifying the competition. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/results-usatf/get-schedule-by-day \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","meet_id":"<string>"}'
```

## 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.