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

> Find live soccer match schedules, scores, and team information across German leagues and Europe's top competitions, with the ability to filter by date, team, or league. Quickly look up upcoming fixtures, past results, and complete team schedules for Bundesliga, Premier League, La Liga, Serie A, Ligue 1, Champions League, and more.

**Category:** Sports | **Website:** [fussballdaten.de/](https://fussballdaten.de/) | **Docs:** [parse.bot/marketplace/89e36209-8c5b-446e-862f-f69567bd8c2a/fussballdaten-de-api](https://parse.bot/marketplace/89e36209-8c5b-446e-862f-f69567bd8c2a/fussballdaten-de-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/fussballdaten/`
**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 matches by date

Retrieve all soccer matches scheduled for a specific date across all tracked competitions. Returns match details including teams, scores (for completed matches), kick-off times (for upcoming), and competition context. Supports filtering by league group. When no date is provided, returns today's matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYY-MM-DD format. When omitted, returns today's matches. |
| `filter` | string | No | Filter matches by league group. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fussballdaten/get-matches-by-date \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","filter":"<string>"}'
```

### Get team schedule

Retrieve the full season schedule for a specific team across all competitions (league, cup, Champions League, etc.). Shows both past results (with scores and outcome) and upcoming matches (with kick-off times). Use search_teams to discover valid team slugs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_slug` | string | Yes | Team URL slug from search_teams endpoint. Examples: 'fc-bayern-muenchen', 'borussia-dortmund', 'hamburger-sv'. |

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

### Get upcoming matches

Collect upcoming matches over the next N days (up to 60). Iterates through daily calendar pages and aggregates results. Supports league-group filtering and team-name filtering (case-insensitive partial match). Each day is a separate page fetch, so larger day ranges are slower.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `days` | integer | No | Number of days to look ahead from today (max 60). |
| `filter` | string | No | Filter matches by league group. |
| `teams` | string | No | Comma-separated team names to filter (case-insensitive partial match). Example: 'Bayern,Dortmund,Chelsea,Real Madrid'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fussballdaten/get-upcoming-matches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"days":"<integer>","filter":"<string>","teams":"<string>"}'
```

### Search teams

Browse and search for teams on fussballdaten.de to find their URL slugs. Lists Bundesliga teams and top international clubs available on the site. Use the returned slug with get_team_schedule to retrieve a team's full season schedule.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search term to filter teams (case-insensitive partial match on name or slug). When omitted, lists all available teams. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fussballdaten/search-teams \
  -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.