# Scorecatonline — 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 live gymnastics competition results, schedules, and meet information from across the country, with the ability to search meets, view session scores, and filter by state and season. Get detailed breakdowns of individual and team performances at specific gymnastics events.

**Category:** Sports | **Website:** [scorecatonline.com/](https://scorecatonline.com/) | **Docs:** [parse.bot/marketplace/4b5168b7-5691-457e-8e92-5e140fdeefa3/scorecatonline-com-api](https://parse.bot/marketplace/4b5168b7-5691-457e-8e92-5e140fdeefa3/scorecatonline-com-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-scorecatonline-com-api-4b5168b7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_individual_session_results

Retrieve individual athlete scores and rankings for a specific session. Returns detailed per-event scores, judge scores, deductions, start values, and overall rankings ordered by all-around rank (event7Rank).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `meet_session_id` | string | Yes | Unique session identifier (sessionId or docId from get_meet_sessions results, e.g. '069d3897-dc47-4db3-a22a-2f676a900a51'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scorecatonline-com-api-4b5168b7/get_individual_session_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"meet_session_id":"<string>"}'
```

### get_meet_details

Get full details for a specific meet by its document ID. Returns all meet fields including session schedule, rotation types, events configuration, gymnasts list, and logo URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `meet_id` | string | Yes | Unique meet document identifier (docId from list_meets or search_meets results, e.g. '4WRY436F'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scorecatonline-com-api-4b5168b7/get_meet_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"meet_id":"<string>"}'
```

### get_meet_sessions

Retrieve the list of scored sessions for a specific meet. Each session represents a competitive grouping (level, division, age group) with aggregate statistics like average scores per event.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `meet_id` | string | Yes | Unique meet identifier (docId from list_meets results, e.g. '4WRY436F'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scorecatonline-com-api-4b5168b7/get_meet_sessions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"meet_id":"<string>"}'
```

### get_seasons_list

Retrieve available competition seasons for filtering. Returns seasons in 'YYYY-YYYY' format sorted most recent first.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scorecatonline-com-api-4b5168b7/get_seasons_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_states_list

Retrieve the list of US state codes that have at least one meet in the database. Useful for populating filter dropdowns.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scorecatonline-com-api-4b5168b7/get_states_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_team_session_results

Retrieve team rankings and aggregate scores for a specific session. Returns per-event team totals and overall team rankings. Only available for sessions that have team scoring enabled.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `meet_session_id` | string | Yes | Unique session identifier (sessionId or docId from get_meet_sessions results, e.g. 'ae1128ad-aa6f-4b2b-8b17-2878901b02b2'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scorecatonline-com-api-4b5168b7/get_team_session_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"meet_session_id":"<string>"}'
```

### list_meets

Retrieve a list of gymnastics meets/competitions, optionally filtered by US state and competition season. Returns lightweight meet summaries ordered by start date (most recent first). Without filters, returns all meets across all states and seasons.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | Competition season filter in 'YYYY-YYYY' format (e.g. '2025-2026', '2024-2025'). |
| `state` | string | No | Two-letter US state code filter (e.g. 'OK', 'KY', 'CA'). Some entries may be international codes. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scorecatonline-com-api-4b5168b7/list_meets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>","state":"<string>"}'
```

### search_meets

Search for meets by keyword in the meet name or host gym name. Performs case-insensitive substring matching across all meets. Returns lightweight meet summaries ordered by start date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against meet name or host gym name (case-insensitive substring match). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scorecatonline-com-api-4b5168b7/search_meets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```