> For the complete documentation index, see [llms.txt](https://docs.sportmonks.com/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportmonks.com/v3/sportmonks-ai-docs/machine-readable-docs.md). # 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](https://static.sportmonks.com/openapi_spec.json) > 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://llmstxt.org): ``` 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sportmonks.com/v3/sportmonks-ai-docs/machine-readable-docs.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.