Machine Readable Docs

Copy one of the context blocks below and paste it into any AI tool. It gives the AI enough knowledge of the Sportmonks API to help you build - no installation, no setup.

Works with Claude, ChatGPT, Gemini, Mistral, Copilot, Cursor, and any other LLM.

Which block should I use?

Block	Size	Best for
Minimal	~400 tokens	Quick questions, one-off lookups, tight context budgets
Full	~2,000 tokens	Building something real - endpoints, includes, filters, and common IDs all included
OpenAPI spec	~22,000 tokens	Tool configuration, code generation, or Custom GPT Actions

Minimal context

Sportmonks Football API v3

Base URL: https://api.sportmonks.com/v3/football
Auth: ?api_token=YOUR_TOKEN (query parameter on every request)

Key endpoints:
GET /players/search/{query}
GET /teams/search/{query}
GET /leagues/search/{query}
GET /fixtures/{id}
GET /fixtures/date/{date}
GET /livescores/inplay
GET /squads/teams/{team_id}
GET /standings/live/leagues/{league_id}
GET /topscorers/seasons/{season_id}

Includes: semicolon-separated (e.g. include=participants;scores;league;state)
Filters: key:value syntax (e.g. filters=fixtureLeagues:8)
Pagination: ?page=1&per_page=25

Docs: https://docs.sportmonks.com/football

Full context

Sportmonks Football API v3

Base URL: https://api.sportmonks.com/v3/football
Core API: https://api.sportmonks.com/v3/core
Auth: ?api_token=YOUR_TOKEN on every request

--- SEARCH ---
GET /players/search/{query}
GET /teams/search/{query}
GET /leagues/search/{query}

--- PLAYERS & TEAMS ---
GET /players/{id}
GET /teams/{id}
GET /leagues/{id}

--- SQUADS ---
GET /squads/teams/{team_id}
GET /squads/seasons/{season_id}/teams/{team_id}

--- FIXTURES ---
GET /fixtures/{id}
GET /fixtures/date/{date}
GET /fixtures/between/{start}/{end}
GET /fixtures/between/{start}/{end}/{team_id}
GET /fixtures/head-to-head/{team1_id}/{team2_id}
GET /livescores/inplay
GET /livescores

--- STANDINGS ---
GET /standings/seasons/{season_id}
GET /standings/live/leagues/{league_id}
GET /standings/rounds/{round_id}

--- TOPSCORERS ---
GET /topscorers/seasons/{season_id}
Common type IDs: goals=208, assists=209, yellow cards=84

--- INCLUDES ---
Pass as semicolon-separated string:
participants       - the two teams
scores             - current and final scoreline
state              - match state (NS/LIVE/HT/FT/AET/PEN)
league             - league name and ID
round              - gameweek/matchday
events             - goals, cards, substitutions
lineups            - starting XI and bench
statistics         - team stats (shots, possession, corners, etc.)
periods            - first half, second half breakdown
venue              - stadium info
player             - full player object (nest inside squad/lineup)
position           - player position
detailedPosition   - more granular position

--- FILTERS ---
Pass as key:value syntax:
fixtureLeagues:{league_id}        - filter fixtures by league
fixtureStates:{state_id,state_id} - filter by match state (2=1H, 22=2H)
fixturestatisticTypes:{type_ids}  - filter stat types
eventTypes:{type_ids}             - filter event types
seasonTopscorerTypes:{type_id}    - filter topscorer type

--- PAGINATION ---
?page=1&per_page=25&order=asc

--- COMMON IDs ---
Premier League: league_id=8
La Liga: league_id=564
Bundesliga: league_id=82
Serie A: league_id=384
Ligue 1: league_id=301
Champions League: league_id=2
World Cup 2026: league_id=732, season_id=26618

Docs: https://docs.sportmonks.com/football

OpenAPI specification

The full OpenAPI spec for the Sportmonks Football API v3. Import it into your AI tool, code editor, or use it to configure a Custom GPT Action.

Download OpenAPI spec

At ~22,000 tokens this is large. Use the minimal or full context blocks above for most tasks - reserve the spec for tool configuration or code generation.

llms.txt

Sportmonks publishes a machine-readable documentation index following the llms.txt standard:

https://docs.sportmonks.com/llms.txt

AI tools and crawlers can fetch this to get a structured overview of all Sportmonks APIs - Football, Motorsport, Odds, Core, and Widgets. Paste the URL into any AI tool to give it a broad orientation before diving into a specific API.