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

> Search athletes, view their performance history, and look up detailed results from track and field meets including event standings and team rosters. Get comprehensive information about cross country and track competitions with athlete times, placements, and meet details all in one place.

**Category:** Sports | **Website:** [tfrrs.org/](https://tfrrs.org/) | **Docs:** [parse.bot/marketplace/9bece3bf-9c0f-449e-a946-22b339070d1a/tfrrs-org-api](https://parse.bot/marketplace/9bece3bf-9c0f-449e-a946-22b339070d1a/tfrrs-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/tfrrs/`
**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 results

Get detailed performance results for a specific college athlete, including personal bests and competition history. Returns track/field and cross country performances with marks, placements, and meet information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `athlete_id` | string | Yes | Numeric athlete ID from TFRRS (e.g., '123456', obtainable from search_athlete results) |

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

### Get event results

Get results for a specific event within a meet. Returns individual athlete placements, marks, and team affiliations. The event_url is obtained from get_meet_results events array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_url` | string | Yes | Full URL of the event results page from get_meet_results events[].url (e.g., 'https://tfrrs.org/results/{meet_id}/{event_id}/{Meet_Name}/{Event_Name}') |

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

### Get meet results

Get basic information and event listings for a specific college meet. Returns the meet name, list of event result page URLs, and a partial list of athletes found. Only college-level meets indexed by TFRRS will have populated event lists; high school or unindexed meets may return empty arrays.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `meet_id` | string | Yes | Numeric meet ID from TFRRS (e.g., '12345') |

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

### Get team roster

Get the roster of athletes for a specific college team. Returns the team name and list of athletes with their TFRRS IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_url` | string | Yes | Path or full URL of the team page, following the format '/teams/tf/{STATE}_college_{m\|f}_{School}.html' (e.g., '/teams/tf/MA_college_m_Harvard.html' for Harvard men's team) |

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

### Search athlete

Search for college athletes by name on TFRRS. Returns matching athletes from the NCAA/NAIA/NJCAA database. Only athletes registered in TFRRS (current or recent college athletes) will return results; professional or post-collegiate athletes not in the system will return an empty array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Athlete name to search for (e.g., 'Emma Coburn') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/tfrrs/search-athlete \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<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.