# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-results-usatf-org-api-33541413/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-results-usatf-org-api-33541413/get_athlete_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-results-usatf-org-api-33541413/get_competition_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-results-usatf-org-api-33541413/get_event_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-results-usatf-org-api-33541413/get_para_nationals_schedule_by_day \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-results-usatf-org-api-33541413/get_schedule_by_day \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","meet_id":"<string>"}'
```