# Mlssoccer — 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 MLS soccer scores, match schedules, and detailed game information across all major competitions including the Regular Season, US Open Cup, and CONCACAF Champions Cup. Retrieve real-time match data and comprehensive details for any MLS team.

**Category:** Sports | **Website:** [www.mlssoccer.com/](https://www.mlssoccer.com/) | **Docs:** [parse.bot/marketplace/59eb6a28-5d2f-47c5-98a5-9515d013e469/mlssoccer-com-api](https://parse.bot/marketplace/59eb6a28-5d2f-47c5-98a5-9515d013e469/mlssoccer-com-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/mlssoccer/`
**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 match details

Get detailed information about a specific match including team logos, broadcasters, streaming URLs, venue, and competition details. Returns stale_input with kind input_not_found if the match ID does not exist. Match IDs follow the pattern MLS-MAT-XXXXXX.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | Match ID (e.g., 'MLS-MAT-0009FO'). Obtain from get_matches endpoint matches[*].match_id. |

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

### Get matches

Get MLS matches for a date range. Returns live scores, upcoming matches with start times, and completed results. Includes match status (scheduled, live, finalWhistle), team names, scores, kickoff times, and venue info. Results are sorted by kickoff time. When competition is omitted or unrecognized, returns all competitions without filtering.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `competition` | string | No | Filter by competition. Returns all competitions if omitted or unrecognized. |
| `date_from` | string | No | Start date in YYYY-MM-DD format. Defaults to yesterday relative to current UTC date. |
| `date_to` | string | No | End date in YYYY-MM-DD format. Defaults to 6 days from current UTC date. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/mlssoccer/get-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"competition":"<string>","date_from":"<string>","date_to":"<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.