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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-mlssoccer-com-api-59eb6a28/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-mlssoccer-com-api-59eb6a28/get_match_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-mlssoccer-com-api-59eb6a28/get_matches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"competition":"<string>","date_from":"<string>","date_to":"<string>"}'
```