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

> Get live match scores, search matches by team, and view tournament standings and national team information from Norwegian football competitions. Track today's matches, access detailed match information, and browse regional football data all in one place.

**Category:** Sports | **Website:** [fotball.no/](https://fotball.no/) | **Docs:** [parse.bot/marketplace/c7beeaa1-6f57-4167-a0e7-7f5fd312cbd9/fotball-no-api](https://parse.bot/marketplace/c7beeaa1-6f57-4167-a0e7-7f5fd312cbd9/fotball-no-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/fotball/`
**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 for a specific match including title, venue, referees, and match events. Events and referees may be empty arrays for future or unplayed matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `fiks_id` | string | Yes | Match FIKS ID (numeric string, e.g. '8986194'). Available from get_todays_matches or get_tournament_matches results. |

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

### Get todays matches

Get all matches scheduled for a given date. Returns match details including teams, time, venue, and tournament. Defaults to today if no date specified. Results may be empty on days with no scheduled games.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `club` | string | No | Filter by club ID. |
| `date` | string | No | Date in YYYY-MM-DD format. Omitting returns today's matches. |
| `district` | string | No | Filter by district ID. |

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

### Get tournament matches

Get all upcoming and past matches for a specific tournament. Returns date, time, home/away teams, result (score), venue, and match ID for each fixture. For played matches, result contains the score (e.g. '2 - 1'); for upcoming matches, result is '-' and time contains the kickoff time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tournament` | string | Yes | Tournament slug (e.g. 'eliteserien', 'obosligaen', 'toppserien'). |

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

### Get tournament standings

Get league table/standings for a specific tournament. Returns position, team name, matches played, wins, draws, losses, goals, and points for each team in the table.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tournament` | string | Yes | Tournament slug (e.g. 'eliteserien', 'obosligaen', 'toppserien'). |

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

### List national teams

List all Norwegian national teams including men's, women's, youth, and futsal teams. Returns team name, slug, and URL for each.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fotball/list-national-teams \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List regions

List all Norwegian football regions (kretser). Returns region name and URL for each.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/fotball/list-regions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search matches by team

Search for tournaments a team participates in for a given season. Returns tournament names, URLs, and slugs. The team_name is matched against club registrations in the Norwegian football system.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season_id` | string | No | Season ID. |
| `team_name` | string | Yes | Team name to search for (e.g. 'Rosenborg', 'Aalesund', 'Viking'). |

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