# Scorecatonline — 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 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/scorecatonline/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/scorecatonline/get-individual-session-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scorecatonline/get-meet-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scorecatonline/get-meet-sessions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scorecatonline/get-seasons-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scorecatonline/get-states-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scorecatonline/get-team-session-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scorecatonline/list-meets \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scorecatonline/search-meets \
  -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://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.