# GENERATED by docs-site/tools/build_openapi.py from the recorded responses. Do not edit.
openapi: 3.1.0
info:
  title: TheSportsDB API
  version: v1 · measured 5 Oct 2026
  description: |
    TheSportsDB is an open, crowd-sourced database of sports data and artwork. **v1** works with the free keys and with premium keys.

    ```
    GET https://www.thesportsdb.com/api/v1/json/{apiKey}/{endpoint}.php?{parameters}
    ```

    - **Keys:** `123` is the free key for development and testing; the older `3` also works, with the same limits. Premium keys get full results. The key is part of the URL, so treat v1 URLs as secrets.
    - **Free limits:** each endpoint's description gives the records returned to the free and premium keys, measured on 5 Oct 2026, next to the documented limits.
    - **Responses:** one JSON object with one key holding an array of records. The key depends on the endpoint, and each endpoint lists its key. The records' values are strings or `null`.
    - **No results:** the key with `null`, or an empty body. A rejected parameter comes back as text in place of the records, e.g. `{"seasons":"Invalid League ID passed"}`.
    - **Times:** `dateEvent`, `strTime` and `strTimestamp` are **UTC**.
    - **Rate limit:** 30 requests a minute on the free keys, 100 premium, 120 business. Over the limit: HTTP 429; wait a minute.

    The [guides](../index.html) cover these in detail, with [recipes](../recipes.html) for common tasks.
  termsOfService: https://www.thesportsdb.com/docs_terms_of_use.php
servers:
- url: https://www.thesportsdb.com
tags:
- name: Search
  description: Find records by name.
- name: Lookup
  description: Fetch records by id, and the details attached to a team, player or event.
- name: Lists
  description: Lists of leagues, seasons, teams and players.
- name: Schedules
  description: Fixtures and results. Times are UTC.
- name: TV
  description: 'TV listings: which channels show which events.'
- name: Video
  description: Highlight videos.
- name: Live scores
  description: Games in progress.
paths:
  /api/v1/json/{apiKey}/searchteams.php:
    get:
      operationId: searchTeams
      tags:
      - Search
      summary: Search teams by name
      description: |-
        The free keys only find the exact team (1 record).

        Records measured 5 Oct 2026: free key **1**, premium key **15**.

        Documented limit: 1 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: t
        in: query
        required: true
        description: Team name. Spaces as `%20` or `_`.
        schema:
          type: string
        example: Arsenal
      responses:
        '200':
          description: The records under `teams`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  teams:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Team'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                teams:
                - idTeam: '133604'
                  idESPN: '359'
                  idAPIfootball: '42'
                  intLoved: '10'
                  strTeam: Arsenal
                  strTeamAlternate: Arsenal Football Club, AFC, Arsenal FC
                  strTeamShort: ARS
                  intFormedYear: '1892'
                  strSport: Soccer
                  strLeague: English Premier League
                  idLeague: '4328'
                  strLeague2: FA Cup
                  idLeague2: '4482'
                  strLeague3: EFL Cup
                  idLeague3: '4570'
                  strLeague4: UEFA Champions League
                  idLeague4: '4480'
                  strLeague5: Emirates Cup
                  idLeague5: '5648'
                  strLeague6: Club Friendlies
                  idLeague6: '4569'
                  strLeague7: FA Community Shield
                  idLeague7: '4571'
                  strDivision: null
                  idVenue: '15528'
                  strStadium: Emirates Stadium
                  strKeywords: Gunners, Gooners
                  strRSS: ''
                  strLocation: Holloway, London, England
                  strWebsite: www.arsenal.com
                  strFacebook: www.facebook.com/Arsenal
                  strTwitter: twitter.com/arsenal
                  strInstagram: instagram.com/arsenal
                  strDescriptionEN: Arsenal Football Club is a professional football club based in Islington, London, England,
                    that plays in the Premier League, the top flight of English footba…
                  strDescriptionDE: 'Der FC Arsenal (offiziell: Arsenal Football Club) – auch bekannt als (The) Arsenal, (The)
                    Gunners (deutsche Übersetzung: „Schützen“ oder „Kanoniere“) oder im…'
                  strDescriptionFR: "Arsenal Football Club est un club de football anglais fondé le 1er décembre 1886 à Londres.\
                    \ Son siège est situé dans le borough londonien d'Islington.\r\n\r\nArs…"
                  strDescriptionCN: null
                  strDescriptionIT: L'Arsenal Football Club, noto semplicemente come Arsenal, è una società calcistica inglese
                    con sede a Londra, più precisamente nel quartiere di Holloway, nel…
                  strDescriptionJP: "アーセナル・フットボール・クラブ（Arsenal Football Club、イギリス英語発音: [ˈɑːsənl ˈfutˌbɔːl klʌb]）は、イングランドの首都ロンドン北部をホームタウンとする、イングランドプロサッカーリーグ（プレミアリーグ）に加盟するプロサッカークラブ。クラブカラーは赤と白。\r\
                    \n\r\n現…"
                  strDescriptionRU: '«Арсена́л» (официальное полное название — Футбольный клуб «Арсенал», англ. Arsenal Football
                    Club, английское произношение: [ˈɑrsənəl ''futbɔ:l klʌb]) — англий…'
                  strDescriptionES: 'El Arsenal Football Club (pronunciación en inglés: /ˈɑː(ɹ)sənəl ˈfʊtˌbɔl klʌb/) es un
                    club de fútbol profesional con sede en Holloway, Londres, Inglaterra, q…'
                  strDescriptionPT: "Arsenal Football Club é um clube de futebol, fundado e baseado em Londres, capital da\
                    \ Inglaterra.\r\n\r\nO clube disputa a Premier League e é um dos mais bem suc…"
                  strDescriptionSE: null
                  strDescriptionNL: null
                  strDescriptionHU: null
                  strDescriptionNO: Arsenal Football Club er en engelsk fotballklubb som spiller i Premier League. Klubben
                    ble stiftet i 1886, og ble valgt inn i The Football League i 1893. «Th…
                  strDescriptionIL: null
                  strDescriptionPL: null
                  strColour1: '#EF0107'
                  strColour2: '#fbffff'
                  strColour3: '#013373'
                  strGender: Male
                  strCountry: England
                  strBadge: https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png
                  strLogo: https://r2.thesportsdb.com/images/media/team/logo/q2mxlz1512644512.png
                  strFanart1: https://r2.thesportsdb.com/images/media/team/fanart/ouqjzl1769332470.jpg
                  strFanart2: https://r2.thesportsdb.com/images/media/team/fanart/db23ct1769332477.jpg
                  strFanart3: https://r2.thesportsdb.com/images/media/team/fanart/k3r9od1769332483.jpg
                  strFanart4: https://r2.thesportsdb.com/images/media/team/fanart/2uvo8p1731313907.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/team/banner/ecl7mi1790192440.jpg
                  strEquipment: https://r2.thesportsdb.com/images/media/team/equipment/fwav4f1752100996.png
                  strYoutube: www.youtube.com/user/ArsenalTour
                  strLocked: unlocked
                - idTeam: '137301'
                  idESPN: null
                  idAPIfootball: '7189'
                  intLoved: null
                  strTeam: Arsenal U21
                  strTeamAlternate: ''
                  strTeamShort: null
                  intFormedYear: '0'
                  strSport: Soccer
                  strLeague: EFL Trophy
                  idLeague: '4847'
                  strLeague2: EFL Trophy
                  idLeague2: '4847'
                  strLeague3: ''
                  idLeague3: null
                  strLeague4: ''
                  idLeague4: null
                  strLeague5: ''
                  idLeague5: null
                  strLeague6: ''
                  idLeague6: null
                  strLeague7: ''
                  idLeague7: null
                  strDivision: null
                  idVenue: '16300'
                  strStadium: Meadow Park
                  strKeywords: ''
                  strRSS: ''
                  strLocation: Borehamwood
                  strWebsite: ''
                  strFacebook: ''
                  strTwitter: twitter.com/ArsenalAcademy
                  strInstagram: ''
                  strDescriptionEN: Arsenal Football Club Academy is the youth system of Arsenal Football Club based in Hale
                    End, London, England. The academy teams play in the Professional Dev…
                  strDescriptionDE: null
                  strDescriptionFR: null
                  strDescriptionCN: null
                  strDescriptionIT: null
                  strDescriptionJP: null
                  strDescriptionRU: null
                  strDescriptionES: null
                  strDescriptionPT: null
                  strDescriptionSE: null
                  strDescriptionNL: null
                  strDescriptionHU: null
                  strDescriptionNO: null
                  strDescriptionIL: null
                  strDescriptionPL: null
                  strColour1: ''
                  strColour2: ''
                  strColour3: ''
                  strGender: Male
                  strCountry: England
                  strBadge: https://r2.thesportsdb.com/images/media/team/badge/0l60011588514201.png
                  strLogo: null
                  strFanart1: null
                  strFanart2: null
                  strFanart3: null
                  strFanart4: null
                  strBanner: null
                  strEquipment: null
                  strYoutube: ''
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/searchevents.php:
    get:
      operationId: searchEvents
      tags:
      - Search
      summary: Search events by name
      description: |-
        Pass at most one of `s` and `d`.

        Records measured 5 Oct 2026: free key **1**, premium key **10**.

        Documented limit: 1 / 10 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: e
        in: query
        required: true
        description: Event name, `Home vs Away`.
        schema:
          type: string
        example: Arsenal_vs_Chelsea
      - name: s
        in: query
        required: false
        description: Narrow to a season.
        schema:
          type: string
        example: 2016-2017
      - name: d
        in: query
        required: false
        description: Narrow to a date, `YYYY-MM-DD`.
        schema:
          type: string
          format: date
        example: '2015-04-26'
      - name: f
        in: query
        required: false
        description: Alternatively, an event filename (same as `searchfilename.php`).
        schema:
          type: string
        example: English_Premier_League_2015-04-26_Arsenal_vs_Chelsea
      responses:
        '200':
          description: The records under `event`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  event:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                event:
                - idEvent: '2494022'
                  idAPIfootball: '1557387'
                  strTimestamp: '2026-09-06T15:30:00'
                  strEvent: Arsenal vs Chelsea
                  strEventAlternate: Chelsea @ Arsenal
                  strFilename: English Premier League 2026-09-06 Arsenal vs Chelsea
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSeason: 2026-2027
                  strDescriptionEN: Defending champions Arsenal welcome Chelsea to the Emirates Stadium for an early-season
                    London derby between two sides that have started the Premier League c…
                  strHomeTeam: Arsenal
                  strAwayTeam: Chelsea
                  intHomeScore: '2'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '3'
                  intAwayScore: '1'
                  intSpectators: null
                  strOfficial: ''
                  strWeather: ''
                  dateEvent: '2026-09-06'
                  dateEventLocal: '2026-09-06'
                  strTime: '15:30:00'
                  strTimeLocal: '16:30:00'
                  strGroup: ''
                  idHomeTeam: '133604'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png
                  idAwayTeam: '133610'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/pbf4ul1782638263.png
                  intScore: '8'
                  intScoreVotes: '1'
                  strResult: Arsenal recovered from conceding after just 77 seconds to defeat Chelsea 2–1 and preserve their
                    perfect start to the Premier League season. Morgan Rogers gav…
                  idVenue: '15528'
                  strVenue: Emirates Stadium
                  strCountry: England
                  strCity: ''
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/0l3uib1785931591.jpg
                  strSquare: https://r2.thesportsdb.com/images/media/event/square/xgqyzb1785931689.jpg
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/uxuamm1785931532.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/m3ktrt1785931642.jpg
                  strMap: null
                  strTweet1: ''
                  strVideo: https://www.youtube.com/watch?v=af99CJ4f_yc
                  strStatus: FT
                  strPostponed: 'no'
                  strLocked: unlocked
                - idEvent: '2401588'
                  idAPIfootball: '1498260'
                  strTimestamp: '2026-02-03T20:00:00'
                  strEvent: Arsenal vs Chelsea
                  strEventAlternate: Chelsea @ Arsenal
                  strFilename: EFL Cup 2026-02-03 Arsenal vs Chelsea
                  strSport: Soccer
                  idLeague: '4570'
                  strLeague: EFL Cup
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/x1va771565372556.png
                  strSeason: 2025-2026
                  strDescriptionEN: ''
                  strHomeTeam: Arsenal
                  strAwayTeam: Chelsea
                  intHomeScore: '1'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '150'
                  intAwayScore: '0'
                  intSpectators: null
                  strOfficial: ''
                  strWeather: null
                  dateEvent: '2026-02-03'
                  dateEventLocal: '2026-02-03'
                  strTime: '20:00:00'
                  strTimeLocal: '20:00:00'
                  strGroup: ''
                  idHomeTeam: '133604'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png
                  idAwayTeam: '133610'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/yvwvtu1448813215.png
                  intScore: null
                  intScoreVotes: null
                  strResult: ''
                  idVenue: '15528'
                  strVenue: Emirates Stadium
                  strCountry: England
                  strCity: ''
                  strPoster: ''
                  strSquare: ''
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/4k94qw1768369240.jpg
                  strBanner: ''
                  strMap: null
                  strTweet1: ''
                  strVideo: https://www.youtube.com/watch?v=yQaaKW9CzNM
                  strStatus: FT
                  strPostponed: 'no'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/searchfilename.php:
    get:
      operationId: searchEventsByFilename
      tags:
      - Search
      summary: Search events by filename
      description: |-
        Records measured 5 Oct 2026: free key **1**, premium key **1**.

        Documented limit: 1 / 10 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: e
        in: query
        required: true
        description: 'Event filename: `{League} {YYYY-MM-DD} {Home} vs {Away}`.'
        schema:
          type: string
        example: English_Premier_League_2015-04-26_Arsenal_vs_Chelsea
      - name: s
        in: query
        required: false
        description: Narrow to a season.
        schema:
          type: string
        example: 2014-2015
      responses:
        '200':
          description: The records under `event`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  event:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                event:
                - idEvent: '480006'
                  idAPIfootball: null
                  strTimestamp: '2015-04-26T16:00:00'
                  strEvent: Arsenal vs Chelsea
                  strEventAlternate: Chelsea @ Arsenal
                  strFilename: English Premier League 2015-04-26 Arsenal vs Chelsea
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/dsnjpz1679951317.png
                  strSeason: 2014-2015
                  strDescriptionEN: "Chelsea put in another staunch defensive display to draw 0-0 with Arsenal and take another\
                    \ step closer to sealing the Premier League title.\r\nGeorge Graham, f…"
                  strHomeTeam: Arsenal
                  strAwayTeam: Chelsea
                  intHomeScore: '0'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '34'
                  intAwayScore: '0'
                  intSpectators: '60026'
                  strOfficial: null
                  strWeather: null
                  dateEvent: '2015-04-26'
                  dateEventLocal: null
                  strTime: 15:00:00+00:00
                  strTimeLocal: null
                  strGroup: null
                  idHomeTeam: '133604'
                  strHomeTeamBadge: null
                  idAwayTeam: '133610'
                  strAwayTeamBadge: null
                  intScore: null
                  intScoreVotes: null
                  strResult: null
                  idVenue: null
                  strVenue: null
                  strCountry: null
                  strCity: null
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/ywstqs1444121556.jpg
                  strSquare: null
                  strFanart: https://r2.thesportsdb.com/images/media/event/fanart/yrsrvp1444121673.jpg
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/sswrrr1430243855.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/tupqpv1444121225.jpg
                  strMap: https://r2.thesportsdb.com/images/media/event/map/qypvvt1444121357.jpg
                  strTweet1: null
                  strVideo: null
                  strStatus: null
                  strPostponed: 'no'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/searchplayers.php:
    get:
      operationId: searchPlayers
      tags:
      - Search
      summary: Search players by name
      description: |-
        Returns summary fields plus a `relevance` score.

        Records measured 5 Oct 2026: free key **1**, premium key **1**.

        Documented limit: 1 / 10 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: p
        in: query
        required: true
        description: Player name.
        schema:
          type: string
        example: Danny_Welbeck
      responses:
        '200':
          description: The records under `player`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  player:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Player'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                player:
                - idPlayer: '34145395'
                  idTeam: '133610'
                  strPlayer: Danny Welbeck
                  strTeam: Chelsea
                  strSport: Soccer
                  strThumb: https://r2.thesportsdb.com/images/media/player/thumb/f5sgpu1772017716.jpg
                  strCutout: https://r2.thesportsdb.com/images/media/player/cutout/mjo6g31787690678.png
                  strNationality: England
                  dateBorn: '1990-11-26'
                  strStatus: Active
                  strGender: Male
                  strPosition: Centre-Forward
                  relevance: '30.170034408569336'
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/searchvenues.php:
    get:
      operationId: searchVenues
      tags:
      - Search
      summary: Search venues by name
      description: |-
        Records measured 5 Oct 2026: free key **1**, premium key **2**.

        Documented limit: 1 / 10 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: v
        in: query
        required: true
        description: Venue name.
        schema:
          type: string
        example: Wembley
      responses:
        '200':
          description: The records under `venues`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  venues:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Venue'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                venues:
                - idVenue: '23604'
                  idDupe: null
                  strVenue: Wembley Centre of Excellence
                  intLoved: null
                  strVenueAlternate: null
                  strVenueSponsor: null
                  strSport: Soccer
                  strDescriptionEN: null
                  strArchitect: null
                  intCapacity: null
                  strCost: null
                  strCountry: Jamaica
                  strLocation: Hayes, Clarendon, Jamaica
                  strTimezone: UTC -05:00 Eastern Standard Time (EST)
                  intFormedYear: '0'
                  strFanart1: null
                  strFanart2: null
                  strFanart3: null
                  strFanart4: null
                  strThumb: null
                  strLogo: null
                  strMap: null
                  strWebsite: ''
                  strFacebook: ''
                  strInstagram: ''
                  strTwitter: null
                  strYoutube: null
                  strCreativeCommons: 'NO'
                  strLocked: unlocked
                - idVenue: '16163'
                  idDupe: null
                  strVenue: Wembley Stadium
                  intLoved: null
                  strVenueAlternate: Wembley
                  strVenueSponsor: ''
                  strSport: Soccer
                  strDescriptionEN: Wembley Stadium (currently known officially as Wembley Stadium connected by EE for commercial
                    sponsorship reasons) is an association football stadium in Wemb…
                  strArchitect: ''
                  intCapacity: '90000'
                  strCost: £789 million
                  strCountry: England
                  strLocation: Wembley, London
                  strTimezone: UTC +00:00 Greenwich Mean Time (GMT)
                  intFormedYear: '2007'
                  strFanart1: https://r2.thesportsdb.com/images/media/venue/fanart/7tpavy1708696222.jpg
                  strFanart2: https://r2.thesportsdb.com/images/media/venue/fanart/3zirzg1708696411.jpg
                  strFanart3: https://r2.thesportsdb.com/images/media/venue/fanart/c482m41708696417.jpg
                  strFanart4: https://r2.thesportsdb.com/images/media/venue/fanart/ncll4t1708696444.jpg
                  strThumb: https://r2.thesportsdb.com/images/media/venue/thumb/qttuty1420627847.jpg
                  strLogo: https://r2.thesportsdb.com/images/media/venue/logo/zowstr1709984100.png
                  strMap: 51.555556, -0.279444
                  strWebsite: www.wembleystadium.com
                  strFacebook: www.facebook.com/WembleyStadium
                  strInstagram: www.instagram.com/wembleystadium
                  strTwitter: twitter.com/wembleystadium
                  strYoutube: ''
                  strCreativeCommons: 'NO'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupleague.php:
    get:
      operationId: lookupLeague
      tags:
      - Lookup
      summary: Look up a league
      description: |-
        Records measured 5 Oct 2026: free key **1**, premium key **1**.

        Documented limit: 1 / 1 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The league id.
        schema:
          type: integer
        example: 4328
      responses:
        '200':
          description: The records under `leagues`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  leagues:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/League'
                      maxItems: 1
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                leagues:
                - idLeague: '4328'
                  idAPIfootball: '8346'
                  idAPIfootballv3: '39'
                  strSport: Soccer
                  strLeague: English Premier League
                  strLeagueAlternate: Premier League, EPL, England
                  intDivision: '0'
                  idCup: '0'
                  strCurrentSeason: 2026-2027
                  intFormedYear: '1992'
                  dateFirstEvent: '1992-08-15'
                  strGender: Male
                  strCountry: England
                  strWebsite: www.premierleague.com
                  strFacebook: xen-gb.facebook.com/premierleague/
                  strInstagram: www.instagram.com/premierleague
                  strTwitter: twitter.com/premierleague
                  strYoutube: www.youtube.com/channel/UCG5qGWdu8nIRZqJ_GgDwQ-w
                  strRSS: https://feeds.bbci.co.uk/sport/football/rss.xml
                  strDescriptionEN: 'The Premier League, often referred to as the English Premier League or the EPL (legal
                    name: The Football Association Premier League Limited), is the top leve…'
                  strDescriptionDE: Die Premier League (offiziell nach dem Sponsoren „Barclays Premier League“, umgangssprachlich
                    „The Premiership“) ist die höchste Spielklasse im englischen Fu…
                  strDescriptionFR: Le Championnat d'Angleterre de football est une compétition sportive située au sommet
                    de la hiérarchie du football en Angleterre. Lancée en 1888 par la The F…
                  strDescriptionIT: "La Premier League è la massima serie del campionato inglese di calcio ed è gestita dalla\
                    \ Football Association (FA).\r\n\r\nSi tratta di un campionato formato da …"
                  strDescriptionCN: "英格兰足球超级联赛（英语：Premier League），简称英超，過往冠名為巴克萊超級聯賽（Barclays Premier League），是英格蘭足球總會轄下的职业足球联赛，是英格蘭聯賽系統的最高等级联赛，英超由超级联盟负责具体运作，而運作模式為一所以20間球會共同擁有的有限公司。\r\
                    \n英格兰超级联赛成立於1…"
                  strDescriptionJP: "プレミアリーグ（英: Premier League）は、イングランドのサッカーリーグにおけるトップディヴィジョン（1部リーグ）。[1]\r\n\r\n世界中で約10億人以上に視聴され、全世界で最も人気が高いリーグであり[2]、世界最高峰レベルのリーグの一つである。サッカー競技のみならず、全世界のスポーツリーグの中で最もテ…"
                  strDescriptionRU: Премье́р-лига (англ. Premier League) — профессиональная футбольная лига для английских
                    футбольных клубов (также в ней могут играть некоторые клубы из Уэльса[…
                  strDescriptionES: La Premier League, también conocida en el Reino Unido como The Premiership, es la máxima
                    categoría del sistema de Ligas de fútbol de Inglaterra. Comenzó a di…
                  strDescriptionPT: Premier League é uma liga profissional de futebol da Inglaterra e está no topo do sistema
                    de ligas do futebol inglês, sendo a principal competição de futebol…
                  strDescriptionSE: "Premier League, 1992–2007 benämnd FA Premier League, är en engelsk fotbollsliga, grundad\
                    \ 1992, som är den högsta divisionen i det engelska ligasystemet.\r\n\r\n2…"
                  strDescriptionNL: "De Premier League is de hoogste Engelse voetbalcompetitie.\r\n\r\nDe competitie bestaat\
                    \ uit twintig clubs die tussen augustus en mei in totaal 380 wedstrijden sp…"
                  strDescriptionHU: A Premier League (más néven Premiership vagy Barclays Premier League) az angol labdarúgó
                    bajnokságok legfelsőbb osztályának elnevezése. Ez a világ legnézette…
                  strDescriptionNO: Premier League er den engelske toppserien i fotball. Premier League er på toppen av ligasystemet
                    i engelsk fotball, og består av 20 lag, som operer med syste…
                  strDescriptionPL: Premier League (nazywana także English Premier League) – zawodowa liga piłkarska znajdująca
                    się na najwyższym szczeblu rozgrywek piłkarskich w Anglii. Gra w …
                  strDescriptionIL: ע"א פרמייר ליג (The FA Premier League) נגד המועצה להסדר ההימורים בספורט[1] הוא פסק דין
                    של בית המשפט העליון שניתן בשנת 2010. עיקר המחלוקת נסובה סביב רצונן של …
                  strTvRights: "Australia - Stan \r\nCanada - FuboTV [2022-2025]\r\nCarribean - Verticast [2022-2025] \r\n\
                    Hong Kong - Now TV [2022-2025]\r\nIndia - Star Sports [2022-2025]\r\nIndonesi…"
                  strFanart1: https://r2.thesportsdb.com/images/media/league/fanart/odberp1725731801.jpg
                  strFanart2: https://r2.thesportsdb.com/images/media/league/fanart/s0ozu31725731959.jpg
                  strFanart3: https://r2.thesportsdb.com/images/media/league/fanart/44vpk61725732073.jpg
                  strFanart4: https://r2.thesportsdb.com/images/media/league/fanart/grmbt01725731922.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/league/banner/xe1es51638921786.jpg
                  strBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strLogo: https://r2.thesportsdb.com/images/media/league/logo/4c377s1535214890.png
                  strPoster: https://r2.thesportsdb.com/images/media/league/poster/67al0l1719007596.jpg
                  strTrophy: https://r2.thesportsdb.com/images/media/league/trophy/9a6kw51689108793.png
                  strNaming: '{strHomeTeam} vs {strAwayTeam}'
                  strComplete: 'yes'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookuptable.php:
    get:
      operationId: lookupTable
      tags:
      - Lookup
      summary: League table (standings)
      description: |-
        Only some leagues have tables, mostly featured soccer leagues. Omit `s` for the current season. There is no v2 equivalent: use this endpoint with a premium key.

        Records measured 5 Oct 2026: free key **5**, premium key **20**.

        Documented limit: 5 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: l
        in: query
        required: true
        description: The league id.
        schema:
          type: integer
        example: 4328
      - name: s
        in: query
        required: false
        description: A season name, e.g. `2026-2027` (or `2026` for single-year leagues).
        schema:
          type: string
        example: 2026-2027
      responses:
        '200':
          description: The records under `table`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  table:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Standing'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                table:
                - idStanding: '9873035'
                  intRank: '1'
                  idTeam: '133613'
                  strTeam: Manchester City
                  strBadge: https://r2.thesportsdb.com/images/media/team/badge/vwpvry1467462651.png/tiny
                  idLeague: '4328'
                  strLeague: English Premier League
                  strSeason: 2026-2027
                  strGroup: Premier League
                  strForm: WWWWW
                  strDescription: Promotion - Champions League (League phase)
                  intPlayed: '5'
                  intWin: '5'
                  intLoss: '0'
                  intDraw: '0'
                  intGoalsFor: '13'
                  intGoalsAgainst: '5'
                  intGoalDifference: '8'
                  intPoints: '15'
                  dateUpdated: '2026-09-24 10:00:07'
                - idStanding: '9873036'
                  intRank: '2'
                  idTeam: '133604'
                  strTeam: Arsenal
                  strBadge: https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png/tiny
                  idLeague: '4328'
                  strLeague: English Premier League
                  strSeason: 2026-2027
                  strGroup: Premier League
                  strForm: LWWWW
                  strDescription: Promotion - Champions League (League phase)
                  intPlayed: '5'
                  intWin: '4'
                  intLoss: '1'
                  intDraw: '0'
                  intGoalsFor: '8'
                  intGoalsAgainst: '4'
                  intGoalDifference: '4'
                  intPoints: '12'
                  dateUpdated: '2026-09-24 10:00:07'
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupteam.php:
    get:
      operationId: lookupTeam
      tags:
      - Lookup
      summary: Look up a team
      description: |-
        Records measured 5 Oct 2026: free key **1**, premium key **1**.

        Documented limit: 1 / 1 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The team id.
        schema:
          type: integer
        example: 133604
      responses:
        '200':
          description: The records under `teams`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  teams:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Team'
                      maxItems: 1
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                teams:
                - idTeam: '133604'
                  idESPN: '359'
                  idAPIfootball: '42'
                  intLoved: '10'
                  strTeam: Arsenal
                  strTeamAlternate: Arsenal Football Club, AFC, Arsenal FC
                  strTeamShort: ARS
                  intFormedYear: '1892'
                  strSport: Soccer
                  strLeague: English Premier League
                  idLeague: '4328'
                  strLeague2: FA Cup
                  idLeague2: '4482'
                  strLeague3: EFL Cup
                  idLeague3: '4570'
                  strLeague4: UEFA Champions League
                  idLeague4: '4480'
                  strLeague5: Emirates Cup
                  idLeague5: '5648'
                  strLeague6: Club Friendlies
                  idLeague6: '4569'
                  strLeague7: FA Community Shield
                  idLeague7: '4571'
                  strDivision: null
                  idVenue: '15528'
                  strStadium: Emirates Stadium
                  strKeywords: Gunners, Gooners
                  strRSS: ''
                  strLocation: Holloway, London, England
                  strWebsite: www.arsenal.com
                  strFacebook: www.facebook.com/Arsenal
                  strTwitter: twitter.com/arsenal
                  strInstagram: instagram.com/arsenal
                  strDescriptionEN: Arsenal Football Club is a professional football club based in Islington, London, England,
                    that plays in the Premier League, the top flight of English footba…
                  strDescriptionDE: 'Der FC Arsenal (offiziell: Arsenal Football Club) – auch bekannt als (The) Arsenal, (The)
                    Gunners (deutsche Übersetzung: „Schützen“ oder „Kanoniere“) oder im…'
                  strDescriptionFR: "Arsenal Football Club est un club de football anglais fondé le 1er décembre 1886 à Londres.\
                    \ Son siège est situé dans le borough londonien d'Islington.\r\n\r\nArs…"
                  strDescriptionCN: null
                  strDescriptionIT: L'Arsenal Football Club, noto semplicemente come Arsenal, è una società calcistica inglese
                    con sede a Londra, più precisamente nel quartiere di Holloway, nel…
                  strDescriptionJP: "アーセナル・フットボール・クラブ（Arsenal Football Club、イギリス英語発音: [ˈɑːsənl ˈfutˌbɔːl klʌb]）は、イングランドの首都ロンドン北部をホームタウンとする、イングランドプロサッカーリーグ（プレミアリーグ）に加盟するプロサッカークラブ。クラブカラーは赤と白。\r\
                    \n\r\n現…"
                  strDescriptionRU: '«Арсена́л» (официальное полное название — Футбольный клуб «Арсенал», англ. Arsenal Football
                    Club, английское произношение: [ˈɑrsənəl ''futbɔ:l klʌb]) — англий…'
                  strDescriptionES: 'El Arsenal Football Club (pronunciación en inglés: /ˈɑː(ɹ)sənəl ˈfʊtˌbɔl klʌb/) es un
                    club de fútbol profesional con sede en Holloway, Londres, Inglaterra, q…'
                  strDescriptionPT: "Arsenal Football Club é um clube de futebol, fundado e baseado em Londres, capital da\
                    \ Inglaterra.\r\n\r\nO clube disputa a Premier League e é um dos mais bem suc…"
                  strDescriptionSE: null
                  strDescriptionNL: null
                  strDescriptionHU: null
                  strDescriptionNO: Arsenal Football Club er en engelsk fotballklubb som spiller i Premier League. Klubben
                    ble stiftet i 1886, og ble valgt inn i The Football League i 1893. «Th…
                  strDescriptionIL: null
                  strDescriptionPL: null
                  strColour1: '#EF0107'
                  strColour2: '#fbffff'
                  strColour3: '#013373'
                  strGender: Male
                  strCountry: England
                  strBadge: https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png
                  strLogo: https://r2.thesportsdb.com/images/media/team/logo/q2mxlz1512644512.png
                  strFanart1: https://r2.thesportsdb.com/images/media/team/fanart/ouqjzl1769332470.jpg
                  strFanart2: https://r2.thesportsdb.com/images/media/team/fanart/db23ct1769332477.jpg
                  strFanart3: https://r2.thesportsdb.com/images/media/team/fanart/k3r9od1769332483.jpg
                  strFanart4: https://r2.thesportsdb.com/images/media/team/fanart/2uvo8p1731313907.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/team/banner/ecl7mi1790192440.jpg
                  strEquipment: https://r2.thesportsdb.com/images/media/team/equipment/fwav4f1752100996.png
                  strYoutube: www.youtube.com/user/ArsenalTour
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupequipment.php:
    get:
      operationId: lookupEquipment
      tags:
      - Lookup
      summary: A team's kits
      description: |-
        Records measured 5 Oct 2026: free key **2**, premium key **18**.

        Documented limit: 2 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The team id.
        schema:
          type: integer
        example: 133597
      responses:
        '200':
          description: The records under `equipment`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  equipment:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Equipment'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                equipment:
                - idEquipment: '612'
                  idTeam: '133597'
                  date: '2019-08-16 13:22:58'
                  strSeason: 2019-2020
                  strEquipment: https://r2.thesportsdb.com/images/media/team/equipment/2019-133597-Jersey.png
                  strType: 1st
                  strUsername: smudgie
                - idEquipment: '1842'
                  idTeam: '133597'
                  date: '2020-11-03 14:12:47'
                  strSeason: 2020-2021
                  strEquipment: https://r2.thesportsdb.com/images/media/team/equipment/xhnsto1604412760.png
                  strType: 1st
                  strUsername: smudgie
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupplayer.php:
    get:
      operationId: lookupPlayer
      tags:
      - Lookup
      summary: Look up a player
      description: |-
        Records measured 5 Oct 2026: free key **1**, premium key **1**.

        Documented limit: 1 / 1 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The player id.
        schema:
          type: integer
        example: 34145937
      responses:
        '200':
          description: The records under `players`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  players:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Player'
                      maxItems: 1
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                players:
                - idPlayer: '34145937'
                  idTeam: '137154'
                  idTeam2: null
                  idTeamNational: null
                  idAPIfootball: '1917'
                  idPlayerManager: '43001238'
                  idWikidata: Q129700
                  idTransferMkt: '45146'
                  idESPN: '100681'
                  idGoogle: null
                  strNationality: Italy
                  strPlayer: Mario Balotelli
                  strPlayerAlternate: Mario Balotelli Barwuah
                  strTeam: _Free Agent Soccer
                  strTeam2: ''
                  strSport: Soccer
                  intSoccerXMLTeamID: '6'
                  dateBorn: '1990-08-12'
                  dateDied: null
                  strNumber: '9'
                  dateSigned: '2014-08-25'
                  strSigning: ''
                  strWage: ''
                  strOutfitter: ''
                  strKit: ''
                  strAgent: ''
                  strBirthLocation: Palermo, Italy
                  strDeathLocation: null
                  strEthnicity: Black
                  strStatus: Free Agent
                  strDescriptionEN: Mario Balotelli Barwuah (né Barwuah; born 12 August 1990) is an Italian professional footballer
                    who plays as a striker for UAE First Division club Al-Ittifaq…
                  strDescriptionDE: null
                  strDescriptionFR: null
                  strDescriptionCN: null
                  strDescriptionIT: null
                  strDescriptionJP: null
                  strDescriptionRU: null
                  strDescriptionES: null
                  strDescriptionPT: null
                  strDescriptionSE: null
                  strDescriptionNL: null
                  strDescriptionHU: null
                  strDescriptionNO: null
                  strDescriptionIL: null
                  strDescriptionPL: null
                  strGender: Male
                  strSide: Right
                  strPosition: Centre-Forward
                  strCollege: null
                  strFacebook: www.facebook.com/MarioOfficialBalotelli
                  strWebsite: ''
                  strTwitter: twitter.com/finallymario
                  strInstagram: instagram.com/mb459
                  strYoutube: ''
                  strHeight: 189 cm
                  strWeight: 192 lbs
                  intLoved: '0'
                  strThumb: https://r2.thesportsdb.com/images/media/player/thumb/k3sczt1714571705.jpg
                  strPoster: null
                  strCutout: https://r2.thesportsdb.com/images/media/player/cutout/alfgb41610666098.png
                  strCartoon: null
                  strRender: https://r2.thesportsdb.com/images/media/player/render/sz8mu61654253818.png
                  strBanner: null
                  strFanart1: https://r2.thesportsdb.com/images/media/player/fanart/wwtsqs1431622222.jpg
                  strFanart2: https://r2.thesportsdb.com/images/media/player/fanart/upxsxy1431622235.jpg
                  strFanart3: https://r2.thesportsdb.com/images/media/player/fanart/vxqsyv1431622253.jpg
                  strFanart4: https://r2.thesportsdb.com/images/media/player/fanart/tvxuyq1431622269.jpg
                  strCreativeCommons: 'Yes'
                  strCreativeCommonsAttribution: By Amirhosseinnakhaeii - Own work, CC0, https://commons.wikimedia.org/w/index.php?curid=190437150
                  strLocked: unlocked
                  strLastName: Balotelli
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookuphonours.php:
    get:
      operationId: lookupHonours
      tags:
      - Lookup
      summary: A player's honours
      description: |-
        Records measured 5 Oct 2026: free key **5**, premium key **5**.

        Documented limit: 5 / 500 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The player id.
        schema:
          type: integer
        example: 34147178
      responses:
        '200':
          description: The records under `honours`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  honours:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Honour'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                honours:
                - id: '11211'
                  idPlayer: '34147178'
                  idTeam: '134284'
                  idLeague: '4351'
                  idHonour: '749'
                  strSport: Soccer
                  strPlayer: Edenilson
                  strTeam: Corinthians
                  strTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/vvuvps1473538042.png
                  strHonour: Brazilian Brasileirao
                  strHonourLogo: https://www.thesportsdb.com/images/media/honour/logo/mxhjar1650460067.png
                  strHonourTrophy: https://www.thesportsdb.com/images/media/honour/trophy/xzspl21650460217.png
                  strSeason: '2011'
                - id: '11214'
                  idPlayer: '34147178'
                  idTeam: '134284'
                  idLeague: '5767'
                  idHonour: '835'
                  strSport: Soccer
                  strPlayer: Edenilson
                  strTeam: Corinthians
                  strTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/vvuvps1473538042.png
                  strHonour: Campeonato Paulista
                  strHonourLogo: https://www.thesportsdb.com/images/media/honour/logo/het0sf1651311964.png
                  strHonourTrophy: https://www.thesportsdb.com/images/media/honour/trophy/gum3741651312014.png
                  strSeason: '2013'
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupformerteams.php:
    get:
      operationId: lookupFormerTeams
      tags:
      - Lookup
      summary: A player's former teams
      description: |-
        Records measured 5 Oct 2026: free key **5**, premium key **6**.

        Documented limit: 5 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The player id.
        schema:
          type: integer
        example: 34147178
      responses:
        '200':
          description: The records under `formerteams`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  formerteams:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/FormerTeam'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                formerteams:
                - id: '11819'
                  idPlayer: '34147178'
                  idFormerTeam: '134284'
                  strSport: Soccer
                  strPlayer: Edenilson
                  strFormerTeam: Corinthians
                  strMoveType: Permanent
                  strBadge: https://r2.thesportsdb.com/images/media/team/badge/vvuvps1473538042.png
                  strJoined: '2011'
                  strDeparted: '2014'
                  intAppearances: null
                  intGoals: null
                - id: '11820'
                  idPlayer: '34147178'
                  idFormerTeam: '133675'
                  strSport: Soccer
                  strPlayer: Edenilson
                  strFormerTeam: Genoa
                  strMoveType: Permanent
                  strBadge: https://r2.thesportsdb.com/images/media/team/badge/rqqvwv1448806429.png
                  strJoined: '2014'
                  strDeparted: '2015'
                  intAppearances: null
                  intGoals: null
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupmilestones.php:
    get:
      operationId: lookupMilestones
      tags:
      - Lookup
      summary: A player's milestones
      description: |-
        Records measured 5 Oct 2026: free key **3**, premium key **3**.

        Documented limit: 5 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The player id.
        schema:
          type: integer
        example: 34161397
      responses:
        '200':
          description: The records under `milestones`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  milestones:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Milestone'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                milestones:
                - id: '455'
                  idPlayer: '34161397'
                  strPlayer: Richarlison
                  idTeam: '133616'
                  idMilestone: '1745'
                  strTeam: Tottenham
                  strSport: Soccer
                  strMilestone: UEFA Champions League Player Of The Match
                  strMilestoneLogo: https://www.thesportsdb.com/images/media/milestone/logo/6230tq1662537994.png
                  dateMilestone: '2022-09-07'
                - id: '1424'
                  idPlayer: '34161397'
                  strPlayer: Richarlison
                  idTeam: '134496'
                  idMilestone: '1843'
                  strTeam: Brazil
                  strSport: Soccer
                  strMilestone: FIFA World Cup Player Of The Match
                  strMilestoneLogo: https://www.thesportsdb.com/images/media/milestone/logo/kzpd281669055640.png
                  dateMilestone: '2022-11-24'
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupcontracts.php:
    get:
      operationId: lookupContracts
      tags:
      - Lookup
      summary: A player's contracts
      description: |-
        Records measured 5 Oct 2026: free key **1**, premium key **1**.

        Documented limit: 1 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The player id.
        schema:
          type: integer
        example: 34147178
      responses:
        '200':
          description: The records under `contracts`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  contracts:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Contract'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                contracts:
                - id: '112'
                  idPlayer: '34147178'
                  idTeam: '134281'
                  strSport: Soccer
                  strPlayer: Edenilson
                  strTeam: Internacional
                  strBadge: https://r2.thesportsdb.com/images/media/team/badge/yprvxx1473538097.png
                  strYearStart: '2018'
                  strYearEnd: '2021'
                  strWage: ''
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/playerresults.php:
    get:
      operationId: playerResults
      tags:
      - Lookup
      summary: A player's results (individual sports)
      description: |-
        For races, golf, fights and similar.

        Records measured 5 Oct 2026: free key **5**, premium key **24**.

        Documented limit: 5 / 500 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The player id.
        schema:
          type: integer
        example: 34160573
      responses:
        '200':
          description: The records under `results`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/EventResult'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                results:
                - idResult: '21890'
                  idPlayer: '34160573'
                  strPlayer: Alexander Sims
                  idTeam: '134826'
                  idEvent: '1392219'
                  strEvent: New York City E Prix Race 2
                  strResult: null
                  intPosition: '4'
                  intPoints: '0'
                  strDetail: + 3.631
                  dateEvent: '2022-07-17'
                  strSeason: 2021-2022
                  strCountry: United Kingdom
                  strSport: Motorsport
                - idResult: '20631'
                  idPlayer: '34160573'
                  strPlayer: Alexander Sims
                  idTeam: '134826'
                  idEvent: '1392216'
                  strEvent: Jakarta E Prix
                  strResult: null
                  intPosition: '15'
                  intPoints: '0'
                  strDetail: '+29.520'
                  dateEvent: '2022-06-04'
                  strSeason: 2021-2022
                  strCountry: United Kingdom
                  strSport: Motorsport
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupplayerstats.php:
    get:
      operationId: lookupPlayerStats
      tags:
      - Lookup
      summary: A player's season statistics
      description: |-
        One record per statistic per season.

        Records measured 5 Oct 2026: free key **10**, premium key **315**.

        Documented limit: 10 / 10000 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The player id.
        schema:
          type: integer
        example: 34146304
      responses:
        '200':
          description: The records under `playerstats`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  playerstats:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/PlayerStat'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                playerstats:
                - id: '5321'
                  idPlayer: '34146304'
                  idTeam: '133908'
                  idLeague: '4502'
                  strSport: Soccer
                  strPlayer: Cristiano Ronaldo
                  strTeam: Portugal
                  strTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/swqvpy1455466083.png
                  strLeague: European Championships
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/el53xu1551733974.png
                  strStatistic: Appearances
                  strValue: '6'
                  strSeason: '2004'
                - id: '5322'
                  idPlayer: '34146304'
                  idTeam: '133908'
                  idLeague: '4502'
                  strSport: Soccer
                  strPlayer: Cristiano Ronaldo
                  strTeam: Portugal
                  strTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/swqvpy1455466083.png
                  strLeague: European Championships
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/el53xu1551733974.png
                  strStatistic: Mins Played
                  strValue: '418'
                  strSeason: '2004'
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupevent.php:
    get:
      operationId: lookupEvent
      tags:
      - Lookup
      summary: Look up an event
      description: |-
        Records measured 5 Oct 2026: free key **1**, premium key **1**.

        Documented limit: 1 / 1 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The event id.
        schema:
          type: integer
        example: 441613
      responses:
        '200':
          description: The records under `events`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                      maxItems: 1
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                events:
                - idEvent: '441613'
                  idAPIfootball: null
                  strTimestamp: '2014-12-29T20:00:00'
                  strEvent: Liverpool vs Swansea
                  strEventAlternate: Swansea @ Liverpool
                  strFilename: English Premier League 2014-12-29 Liverpool vs Swansea
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/dsnjpz1679951317.png
                  strSeason: 2014-2015
                  strDescriptionEN: ''
                  strHomeTeam: Liverpool
                  strAwayTeam: Swansea
                  intHomeScore: '4'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '19'
                  intAwayScore: '1'
                  intSpectators: '44621'
                  strOfficial: null
                  strWeather: null
                  dateEvent: '2014-12-29'
                  dateEventLocal: '2014-12-29'
                  strTime: '20:00:00'
                  strTimeLocal: '20:00:00'
                  strGroup: null
                  idHomeTeam: '133602'
                  strHomeTeamBadge: null
                  idAwayTeam: '133614'
                  strAwayTeamBadge: null
                  intScore: null
                  intScoreVotes: null
                  strResult: ''
                  idVenue: '15407'
                  strVenue: Anfield
                  strCountry: England
                  strCity: Liverpool
                  strPoster: null
                  strSquare: null
                  strFanart: null
                  strThumb: null
                  strBanner: null
                  strMap: null
                  strTweet1: ''
                  strVideo: ''
                  strStatus: null
                  strPostponed: 'no'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/eventresults.php:
    get:
      operationId: eventResults
      tags:
      - Lookup
      summary: An event's results (individual sports)
      description: |-
        Records measured 5 Oct 2026: free key **5**, premium key **22**.

        Documented limit: 5 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The event id.
        schema:
          type: integer
        example: 652890
      responses:
        '200':
          description: The records under `results`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/EventResult'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                results:
                - idResult: '607'
                  idPlayer: '34167526'
                  strPlayer: Justin Barcia
                  idTeam: '135832'
                  idEvent: '652890'
                  strEvent: Anaheim 1
                  strResult: null
                  intPosition: '1'
                  intPoints: '26'
                  strDetail: '1'
                  dateEvent: '2020-01-05'
                  strSeason: '2020'
                  strCountry: United States
                  strSport: Motorsport
                - idResult: '558'
                  idPlayer: '34168462'
                  strPlayer: Adam Cianciarulo
                  idTeam: '135832'
                  idEvent: '652890'
                  strEvent: Anaheim 1
                  strResult: null
                  intPosition: '2'
                  intPoints: '23'
                  strDetail: '1'
                  dateEvent: '2020-01-05'
                  strSeason: '2020'
                  strCountry: United States
                  strSport: Motorsport
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookuplineup.php:
    get:
      operationId: lookupLineup
      tags:
      - Lookup
      summary: An event's lineups
      description: |-
        The old name `lookuplineups.php` returns 404.

        Records measured 5 Oct 2026: free key **5**, premium key **22**.

        Documented limit: 5 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The event id.
        schema:
          type: integer
        example: 1032723
      responses:
        '200':
          description: The records under `lineup`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  lineup:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/LineupEntry'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                lineup:
                - idLineup: '541'
                  idEvent: '1032723'
                  strPosition: Goalkeeper
                  strHome: 'Yes'
                  strSubstitute: 'No'
                  intSquadNumber: '26'
                  idPlayer: '34145423'
                  strPlayer: Emiliano Martinez
                  idTeam: '133601'
                  strTeam: Aston Villa
                  strCutout: https://r2.thesportsdb.com/images/media/player/cutout/ffr5xx1756984715.png
                  strThumb: https://r2.thesportsdb.com/images/media/player/thumb/7drp311770201331.jpg
                  strRender: https://r2.thesportsdb.com/images/media/player/render/2zw8zq1693647864.png
                - idLineup: '539'
                  idEvent: '1032723'
                  strPosition: Midfielder
                  strHome: 'Yes'
                  strSubstitute: 'No'
                  intSquadNumber: '10'
                  idPlayer: '34145477'
                  strPlayer: Jack Grealish
                  idTeam: '133601'
                  strTeam: Aston Villa
                  strCutout: https://r2.thesportsdb.com/images/media/player/cutout/ynkw6r1788879052.png
                  strThumb: https://r2.thesportsdb.com/images/media/player/thumb/ah2exe1771944888.jpg
                  strRender: https://r2.thesportsdb.com/images/media/player/render/uqduki1735801383.png
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookuptimeline.php:
    get:
      operationId: lookupTimeline
      tags:
      - Lookup
      summary: An event's timeline
      description: |-
        Goals, cards and substitutions.

        Records measured 5 Oct 2026: free key **5**, premium key **10**.

        Documented limit: 5 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The event id.
        schema:
          type: integer
        example: 1032718
      responses:
        '200':
          description: The records under `timeline`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  timeline:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/TimelineEntry'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                timeline:
                - idTimeline: '871243'
                  idEvent: '1032718'
                  strTimeline: Card
                  strTimelineDetail: Yellow Card
                  strHome: 'No'
                  strEvent: Sheffield United vs Leeds
                  idAPIfootball: '592167'
                  idPlayer: '34147877'
                  strPlayer: Kalvin Phillips
                  strCutout: null
                  idAssist: null
                  strAssist: ''
                  intTime: '6'
                  strPeriod: null
                  idTeam: '133635'
                  strTeam: Leeds
                  strComment: ''
                  dateEvent: '2020-09-27'
                  strSeason: 2020-2021
                - idTimeline: '871244'
                  idEvent: '1032718'
                  strTimeline: subst
                  strTimelineDetail: Rodrigo
                  strHome: 'No'
                  strEvent: Sheffield United vs Leeds
                  idAPIfootball: '592167'
                  idPlayer: '34161977'
                  strPlayer: Tyler Roberts
                  strCutout: null
                  idAssist: '34149736'
                  strAssist: Rodrigo Moreno Machado
                  intTime: '46'
                  strPeriod: null
                  idTeam: '133635'
                  strTeam: Leeds
                  strComment: ''
                  dateEvent: '2020-09-27'
                  strSeason: 2020-2021
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupeventstats.php:
    get:
      operationId: lookupEventStats
      tags:
      - Lookup
      summary: An event's team statistics
      description: |-
        Records measured 5 Oct 2026: free key **5**, premium key **16**.

        Documented limit: 5 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The event id.
        schema:
          type: integer
        example: 1032723
      responses:
        '200':
          description: The records under `eventstats`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  eventstats:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/EventStat'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                eventstats:
                - idStatistic: '17'
                  idEvent: '1032723'
                  idApiFootball: '592172'
                  strEvent: Aston Villa vs Liverpool
                  strStat: Shots on Goal
                  intHome: '11'
                  intAway: '8'
                - idStatistic: '18'
                  idEvent: '1032723'
                  idApiFootball: '592172'
                  strEvent: Aston Villa vs Liverpool
                  strStat: Shots off Goal
                  intHome: '4'
                  intAway: '1'
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookuptv.php:
    get:
      operationId: lookupEventTv
      tags:
      - Lookup
      summary: The channels showing an event
      description: |-
        Records measured 5 Oct 2026: free key **2**, premium key **13**.

        Documented limit: 2 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The event id.
        schema:
          type: integer
        example: 2494052
      responses:
        '200':
          description: The records under `tvevent`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  tvevent:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/TvListing'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                tvevent:
                - id: '1218715'
                  idEvent: '2494052'
                  intDivision: '0'
                  strSport: Soccer
                  strEvent: Arsenal vs Leeds United
                  strEventThumb: https://r2.thesportsdb.com/images/media/event/thumb/mayo9h1784549326.jpg
                  strEventPoster: https://r2.thesportsdb.com/images/media/event/poster/ekc9q71784549630.jpg
                  strEventBanner: https://r2.thesportsdb.com/images/media/event/banner/h61dc61784549908.jpg
                  strEventSquare: https://r2.thesportsdb.com/images/media/event/square/kzqbsy1784550175.jpg
                  idChannel: '582'
                  strCountry: India
                  strEventCountry: England
                  strLogo: https://r2.thesportsdb.com/images/media/channel/logo/7za33k1683192230.png
                  strChannel: Disney+ Hotstar
                  strSeason: 2026-2027
                  strTime: '11:30:00'
                  dateEvent: '2026-10-10'
                  strTimeStamp: '2026-10-10 11:30:00'
                - id: '1222527'
                  idEvent: '2494052'
                  intDivision: '0'
                  strSport: Soccer
                  strEvent: Arsenal vs Leeds United
                  strEventThumb: https://r2.thesportsdb.com/images/media/event/thumb/mayo9h1784549326.jpg
                  strEventPoster: https://r2.thesportsdb.com/images/media/event/poster/ekc9q71784549630.jpg
                  strEventBanner: https://r2.thesportsdb.com/images/media/event/banner/h61dc61784549908.jpg
                  strEventSquare: https://r2.thesportsdb.com/images/media/event/square/kzqbsy1784550175.jpg
                  idChannel: '5405'
                  strCountry: Romania
                  strEventCountry: England
                  strLogo: https://r2.thesportsdb.com/images/media/channel/logo/bjtbc31632236249.png
                  strChannel: VOYO
                  strSeason: 2026-2027
                  strTime: '11:30:00'
                  dateEvent: '2026-10-10'
                  strTimeStamp: '2026-10-10 11:30:00'
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookupvenue.php:
    get:
      operationId: lookupVenue
      tags:
      - Lookup
      summary: Look up a venue
      description: |-
        Records measured 5 Oct 2026: free key **1**, premium key **1**.

        Documented limit: 1 / 1 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The venue id.
        schema:
          type: integer
        example: 16163
      responses:
        '200':
          description: The records under `venues`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  venues:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Venue'
                      maxItems: 1
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                venues:
                - idVenue: '16163'
                  idDupe: null
                  strVenue: Wembley Stadium
                  intLoved: null
                  strVenueAlternate: Wembley
                  strVenueSponsor: ''
                  strSport: Soccer
                  strDescriptionEN: Wembley Stadium (currently known officially as Wembley Stadium connected by EE for commercial
                    sponsorship reasons) is an association football stadium in Wemb…
                  strArchitect: ''
                  intCapacity: '90000'
                  strCost: £789 million
                  strCountry: England
                  strLocation: Wembley, London
                  strTimezone: UTC +00:00 Greenwich Mean Time (GMT)
                  intFormedYear: '2007'
                  strFanart1: https://r2.thesportsdb.com/images/media/venue/fanart/7tpavy1708696222.jpg
                  strFanart2: https://r2.thesportsdb.com/images/media/venue/fanart/3zirzg1708696411.jpg
                  strFanart3: https://r2.thesportsdb.com/images/media/venue/fanart/c482m41708696417.jpg
                  strFanart4: https://r2.thesportsdb.com/images/media/venue/fanart/ncll4t1708696444.jpg
                  strThumb: https://r2.thesportsdb.com/images/media/venue/thumb/qttuty1420627847.jpg
                  strLogo: https://r2.thesportsdb.com/images/media/venue/logo/zowstr1709984100.png
                  strMap: 51.555556, -0.279444
                  strWebsite: www.wembleystadium.com
                  strFacebook: www.facebook.com/WembleyStadium
                  strInstagram: www.instagram.com/wembleystadium
                  strTwitter: twitter.com/wembleystadium
                  strYoutube: ''
                  strCreativeCommons: 'NO'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/all_sports.php:
    get:
      operationId: allSports
      tags:
      - Lists
      summary: All sports
      description: |-
        Records measured 5 Oct 2026: free key **2**, premium key **37**.

        Documented limit: 2 / 50 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      responses:
        '200':
          description: The records under `sports`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  sports:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Sport'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                sports:
                - idSport: '102'
                  strSport: Soccer
                  strFormat: TeamvsTeam
                  strSportThumb: https://www.thesportsdb.com/images/sports/soccer.jpg
                  strSportThumbBW: https://www.thesportsdb.com/images/sports/bw/soccer.jpg
                  strSportIconGreen: https://www.thesportsdb.com/images/icons/sports/soccer.png
                  strSportDescription: Association football, more commonly known as football or soccer, is a team sport played
                    between two teams of eleven players with a spherical ball. It is play…
                - idSport: '103'
                  strSport: Motorsport
                  strFormat: EventSport
                  strSportThumb: https://www.thesportsdb.com/images/sports/motorsport.jpg
                  strSportThumbBW: https://www.thesportsdb.com/images/sports/bw/motorsport.jpg
                  strSportIconGreen: https://www.thesportsdb.com/images/icons/sports/motorsport.png
                  strSportDescription: Motorsport or motor sport is a global term used to encompass the group of competitive
                    sporting events which primarily involve the use of motorised vehicles, …
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/all_countries.php:
    get:
      operationId: allCountries
      tags:
      - Lists
      summary: All countries
      description: |-
        Name and 32 px flag only; v2 `all/countries` adds codes and more flag sizes.

        Records measured 5 Oct 2026: free key **50**, premium key **256**.

        Documented limit: 50 / 500 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      responses:
        '200':
          description: The records under `countries`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  countries:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Country'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                countries:
                - name_en: Andorra
                  flag_url_32: https://www.thesportsdb.com/images/icons/flags/shiny/32/Andorra.png
                - name_en: United Arab Emirates
                  flag_url_32: https://www.thesportsdb.com/images/icons/flags/shiny/32/United-Arab-Emirates.png
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/all_leagues.php:
    get:
      operationId: allLeagues
      tags:
      - Lists
      summary: All leagues
      description: |-
        Id, name and sport. `strLeagueAlternate` is included **only with a premium key**.

        Records measured 5 Oct 2026: free key **5**, premium key **1547**.

        Documented limit: 10 / 3000 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      responses:
        '200':
          description: The records under `leagues`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  leagues:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/League'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                leagues:
                - idLeague: '4328'
                  strLeague: English Premier League
                  strSport: Soccer
                  strLeagueAlternate: Premier League, EPL, England
                - idLeague: '4329'
                  strLeague: English League Championship
                  strSport: Soccer
                  strLeagueAlternate: England EFL Championship, English Football League Championship
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/search_all_leagues.php:
    get:
      operationId: leaguesInCountry
      tags:
      - Lists
      summary: Leagues in a country
      description: |-
        Full league records. The record key really is `countries`.

        Records measured 5 Oct 2026: free key **5**, premium key **25**.

        Documented limit: 10 / 100 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: c
        in: query
        required: true
        description: Country name, as in `all_countries.php`.
        schema:
          type: string
        example: England
      - name: s
        in: query
        required: false
        description: Sport name.
        schema:
          type: string
        example: Soccer
      responses:
        '200':
          description: The records under `countries`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  countries:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/League'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                countries:
                - idLeague: '4570'
                  idAPIfootball: '8328'
                  idAPIfootballv3: '48'
                  strSport: Soccer
                  strLeague: EFL Cup
                  strLeagueAlternate: Carabao Cup, Football League Cup
                  intDivision: '99'
                  idCup: '1'
                  strCurrentSeason: 2026-2027
                  intFormedYear: '1960'
                  dateFirstEvent: '2006-02-26'
                  strGender: Male
                  strCountry: England
                  strWebsite: www.efl.com/carabao-cup
                  strFacebook: www.facebook.com/TheCarabaoCup/
                  strInstagram: ''
                  strTwitter: twitter.com/carabao_cup
                  strYoutube: ''
                  strRSS: ''
                  strDescriptionEN: The EFL Cup (referred to historically, and colloquially, as simply the League Cup), currently
                    known as the Carabao Cup for sponsorship reasons, is an annual …
                  strDescriptionDE: null
                  strDescriptionFR: null
                  strDescriptionIT: null
                  strDescriptionCN: null
                  strDescriptionJP: null
                  strDescriptionRU: null
                  strDescriptionES: null
                  strDescriptionPT: null
                  strDescriptionSE: null
                  strDescriptionNL: null
                  strDescriptionHU: null
                  strDescriptionNO: null
                  strDescriptionPL: null
                  strDescriptionIL: null
                  strTvRights: US - ESPN [2018-2021]
                  strFanart1: https://r2.thesportsdb.com/images/media/league/fanart/20hqnz1702271389.jpg
                  strFanart2: https://r2.thesportsdb.com/images/media/league/fanart/w7rf3z1708961950.jpg
                  strFanart3: https://r2.thesportsdb.com/images/media/league/fanart/ieww2s1708961927.jpg
                  strFanart4: https://r2.thesportsdb.com/images/media/league/fanart/188reh1702271390.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/league/banner/xfvbps1565451527.jpg
                  strBadge: https://r2.thesportsdb.com/images/media/league/badge/x1va771565372556.png
                  strLogo: https://r2.thesportsdb.com/images/media/league/logo/mgrqhr1565372642.png
                  strPoster: https://r2.thesportsdb.com/images/media/league/poster/6wifr21632278915.jpg
                  strTrophy: https://r2.thesportsdb.com/images/media/league/trophy/e7m3po1709025137.png
                  strNaming: '{strHomeTeam} vs {strAwayTeam}'
                  strComplete: 'yes'
                  strLocked: unlocked
                - idLeague: '4847'
                  idAPIfootball: '8500'
                  idAPIfootballv3: '46'
                  strSport: Soccer
                  strLeague: EFL Trophy
                  strLeagueAlternate: English Football League Trophy
                  intDivision: '99'
                  idCup: '1'
                  strCurrentSeason: 2026-2027
                  intFormedYear: '1983'
                  dateFirstEvent: '2019-03-31'
                  strGender: Male
                  strCountry: England
                  strWebsite: www.efl.com/efl-trophy
                  strFacebook: ''
                  strInstagram: ''
                  strTwitter: ''
                  strYoutube: ''
                  strRSS: ''
                  strDescriptionEN: The EFL Trophy (English Football League Trophy) is an annual English association football
                    knockout competition open to the 48 clubs in EFL League One and EFL…
                  strDescriptionDE: null
                  strDescriptionFR: null
                  strDescriptionIT: null
                  strDescriptionCN: null
                  strDescriptionJP: null
                  strDescriptionRU: null
                  strDescriptionES: null
                  strDescriptionPT: null
                  strDescriptionSE: null
                  strDescriptionNL: null
                  strDescriptionHU: null
                  strDescriptionNO: null
                  strDescriptionPL: null
                  strDescriptionIL: null
                  strTvRights: ''
                  strFanart1: null
                  strFanart2: null
                  strFanart3: null
                  strFanart4: null
                  strBanner: null
                  strBadge: https://r2.thesportsdb.com/images/media/league/badge/txpqvs1757440532.png
                  strLogo: https://r2.thesportsdb.com/images/media/league/logo/e6lt791757441184.png
                  strPoster: null
                  strTrophy: https://r2.thesportsdb.com/images/media/league/trophy/h42b8t1706802574.png
                  strNaming: '{strHomeTeam} vs {strAwayTeam}'
                  strComplete: 'No'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/search_all_seasons.php:
    get:
      operationId: leagueSeasons
      tags:
      - Lists
      summary: A league's seasons
      description: |-
        Season names only unless one of `badge`, `poster` or `description` is set. The parameter is `id`; `l=` returns `{"seasons":"Invalid League ID passed"}`.

        Records measured 5 Oct 2026: free key **5**, premium key **35**.

        Documented limit: 5 / 500 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The league id.
        schema:
          type: integer
        example: 4328
      - name: badge
        in: query
        required: false
        description: '`1` to add `strBadge`.'
        schema:
          type: integer
        example: 1
      - name: poster
        in: query
        required: false
        description: '`1` to add `strPoster`.'
        schema:
          type: integer
        example: 1
      - name: description
        in: query
        required: false
        description: '`1` to add `strDescriptionEN`.'
        schema:
          type: integer
        example: 1
      responses:
        '200':
          description: The records under `seasons`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  seasons:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Season'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                seasons:
                - strSeason: 1992-1993
                - strSeason: 1993-1994
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/search_all_teams.php:
    get:
      operationId: allTeams
      tags:
      - Lists
      summary: Teams in a league, or of a sport in a country
      description: |-
        Pass `l`, or `s` and `c`.

        Records measured 5 Oct 2026: free key **10**, premium key **20**.

        Documented limit: 10 / 3000 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: l
        in: query
        required: false
        description: League **name** (not id).
        schema:
          type: string
        example: English_Premier_League
      - name: s
        in: query
        required: false
        description: Sport name (with `c`).
        schema:
          type: string
        example: Soccer
      - name: c
        in: query
        required: false
        description: Country name (with `s`).
        schema:
          type: string
        example: Spain
      responses:
        '200':
          description: The records under `teams`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  teams:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Team'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                teams:
                - idTeam: '133604'
                  idESPN: '359'
                  idAPIfootball: '42'
                  intLoved: '10'
                  strTeam: Arsenal
                  strTeamAlternate: Arsenal Football Club, AFC, Arsenal FC
                  strTeamShort: ARS
                  intFormedYear: '1892'
                  strSport: Soccer
                  strLeague: English Premier League
                  idLeague: '4328'
                  strLeague2: FA Cup
                  idLeague2: '4482'
                  strLeague3: EFL Cup
                  idLeague3: '4570'
                  strLeague4: UEFA Champions League
                  idLeague4: '4480'
                  strLeague5: Emirates Cup
                  idLeague5: '5648'
                  strLeague6: Club Friendlies
                  idLeague6: '4569'
                  strLeague7: FA Community Shield
                  idLeague7: '4571'
                  strDivision: null
                  idVenue: '15528'
                  strStadium: Emirates Stadium
                  strKeywords: Gunners, Gooners
                  strRSS: ''
                  strLocation: Holloway, London, England
                  strWebsite: www.arsenal.com
                  strFacebook: www.facebook.com/Arsenal
                  strTwitter: twitter.com/arsenal
                  strInstagram: instagram.com/arsenal
                  strDescriptionEN: Arsenal Football Club is a professional football club based in Islington, London, England,
                    that plays in the Premier League, the top flight of English footba…
                  strDescriptionDE: 'Der FC Arsenal (offiziell: Arsenal Football Club) – auch bekannt als (The) Arsenal, (The)
                    Gunners (deutsche Übersetzung: „Schützen“ oder „Kanoniere“) oder im…'
                  strDescriptionFR: "Arsenal Football Club est un club de football anglais fondé le 1er décembre 1886 à Londres.\
                    \ Son siège est situé dans le borough londonien d'Islington.\r\n\r\nArs…"
                  strDescriptionCN: null
                  strDescriptionIT: L'Arsenal Football Club, noto semplicemente come Arsenal, è una società calcistica inglese
                    con sede a Londra, più precisamente nel quartiere di Holloway, nel…
                  strDescriptionJP: "アーセナル・フットボール・クラブ（Arsenal Football Club、イギリス英語発音: [ˈɑːsənl ˈfutˌbɔːl klʌb]）は、イングランドの首都ロンドン北部をホームタウンとする、イングランドプロサッカーリーグ（プレミアリーグ）に加盟するプロサッカークラブ。クラブカラーは赤と白。\r\
                    \n\r\n現…"
                  strDescriptionRU: '«Арсена́л» (официальное полное название — Футбольный клуб «Арсенал», англ. Arsenal Football
                    Club, английское произношение: [ˈɑrsənəl ''futbɔ:l klʌb]) — англий…'
                  strDescriptionES: 'El Arsenal Football Club (pronunciación en inglés: /ˈɑː(ɹ)sənəl ˈfʊtˌbɔl klʌb/) es un
                    club de fútbol profesional con sede en Holloway, Londres, Inglaterra, q…'
                  strDescriptionPT: "Arsenal Football Club é um clube de futebol, fundado e baseado em Londres, capital da\
                    \ Inglaterra.\r\n\r\nO clube disputa a Premier League e é um dos mais bem suc…"
                  strDescriptionSE: null
                  strDescriptionNL: null
                  strDescriptionHU: null
                  strDescriptionNO: Arsenal Football Club er en engelsk fotballklubb som spiller i Premier League. Klubben
                    ble stiftet i 1886, og ble valgt inn i The Football League i 1893. «Th…
                  strDescriptionIL: null
                  strDescriptionPL: null
                  strColour1: '#EF0107'
                  strColour2: '#fbffff'
                  strColour3: '#013373'
                  strGender: Male
                  strCountry: England
                  strBadge: https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png
                  strLogo: https://r2.thesportsdb.com/images/media/team/logo/q2mxlz1512644512.png
                  strFanart1: https://r2.thesportsdb.com/images/media/team/fanart/ouqjzl1769332470.jpg
                  strFanart2: https://r2.thesportsdb.com/images/media/team/fanart/db23ct1769332477.jpg
                  strFanart3: https://r2.thesportsdb.com/images/media/team/fanart/k3r9od1769332483.jpg
                  strFanart4: https://r2.thesportsdb.com/images/media/team/fanart/2uvo8p1731313907.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/team/banner/ecl7mi1790192440.jpg
                  strEquipment: https://r2.thesportsdb.com/images/media/team/equipment/fwav4f1752100996.png
                  strYoutube: www.youtube.com/user/ArsenalTour
                  strLocked: unlocked
                - idTeam: '133601'
                  idESPN: '4328'
                  idAPIfootball: '66'
                  intLoved: null
                  strTeam: Aston Villa
                  strTeamAlternate: Aston Villa FC
                  strTeamShort: AVL
                  intFormedYear: '1874'
                  strSport: Soccer
                  strLeague: English Premier League
                  idLeague: '4328'
                  strLeague2: FA Cup
                  idLeague2: '4482'
                  strLeague3: EFL Cup
                  idLeague3: '4570'
                  strLeague4: UEFA Champions League
                  idLeague4: '4480'
                  strLeague5: UEFA Super Cup
                  idLeague5: '4512'
                  strLeague6: ''
                  idLeague6: null
                  strLeague7: ''
                  idLeague7: null
                  strDivision: null
                  idVenue: '16122'
                  strStadium: Villa Park
                  strKeywords: Villa, The Villa, The Villans and The Lions
                  strRSS: http://www.football365.com/aston-villa/rss
                  strLocation: Aston, Birmingham
                  strWebsite: www.avfc.co.uk
                  strFacebook: www.facebook.com/avfcofficial
                  strTwitter: twitter.com/avfcofficial
                  strInstagram: instagram.com/avfcofficial
                  strDescriptionEN: Aston Villa Football Club is a professional football club based in Aston, Birmingham,
                    England. The club competes in the Premier League, the top tier of the E…
                  strDescriptionDE: null
                  strDescriptionFR: null
                  strDescriptionCN: null
                  strDescriptionIT: L'Aston Villa Football Club, noto semplicemente come Aston Villa,[1] è una società calcistica
                    inglese con sede nel quartiere di Aston della città di Birmingh…
                  strDescriptionJP: null
                  strDescriptionRU: null
                  strDescriptionES: null
                  strDescriptionPT: null
                  strDescriptionSE: null
                  strDescriptionNL: null
                  strDescriptionHU: null
                  strDescriptionNO: null
                  strDescriptionIL: null
                  strDescriptionPL: null
                  strColour1: '#490125'
                  strColour2: '#93bde4'
                  strColour3: '#fee407'
                  strGender: Male
                  strCountry: England
                  strBadge: https://r2.thesportsdb.com/images/media/team/badge/uwzw561787679026.png
                  strLogo: https://r2.thesportsdb.com/images/media/team/logo/bngac51772033192.png
                  strFanart1: https://r2.thesportsdb.com/images/media/team/fanart/p8xxwp1731826441.jpg
                  strFanart2: https://r2.thesportsdb.com/images/media/team/fanart/ywquwr1421747828.jpg
                  strFanart3: https://r2.thesportsdb.com/images/media/team/fanart/cal7fg1485707947.jpg
                  strFanart4: https://r2.thesportsdb.com/images/media/team/fanart/qvpvwq1421747716.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/team/banner/vrttsr1421749709.jpg
                  strEquipment: https://r2.thesportsdb.com/images/media/team/equipment/myv3051785745524.png
                  strYoutube: www.youtube.com/user/avfcofficial
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/lookup_all_players.php:
    get:
      operationId: teamPlayers
      tags:
      - Lists
      summary: A team's squad
      description: |-
        Records measured 5 Oct 2026: free key **10**, premium key **27**.

        Documented limit: 10 / 3000 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The team id.
        schema:
          type: integer
        example: 133604
      responses:
        '200':
          description: The records under `player`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  player:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Player'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                player:
                - idPlayer: '34433685'
                  idTeam: '133604'
                  idTeam2: null
                  idTeamNational: null
                  idAPIfootball: null
                  idPlayerManager: null
                  idWikidata: Q9144353
                  idTransferMkt: null
                  idESPN: null
                  idGoogle: null
                  strNationality: The Netherlands
                  strPlayer: Albert Stuivenberg
                  strPlayerAlternate: ''
                  strTeam: Arsenal
                  strTeam2: ''
                  strSport: Soccer
                  intSoccerXMLTeamID: null
                  dateBorn: '1970-08-05'
                  dateDied: null
                  strNumber: ''
                  dateSigned: null
                  strSigning: ''
                  strWage: ''
                  strOutfitter: ''
                  strKit: ''
                  strAgent: ''
                  strBirthLocation: Rotterdam, Netherlands
                  strDeathLocation: null
                  strEthnicity: White
                  strStatus: Coaching
                  strDescriptionEN: 'Albert Stuivenberg (Dutch pronunciation: ; born 5 August 1970) is a Dutch professional
                    football coach and former player who is currently the assistant manage…'
                  strDescriptionDE: null
                  strDescriptionFR: null
                  strDescriptionCN: null
                  strDescriptionIT: null
                  strDescriptionJP: null
                  strDescriptionRU: null
                  strDescriptionES: null
                  strDescriptionPT: null
                  strDescriptionSE: null
                  strDescriptionNL: null
                  strDescriptionHU: null
                  strDescriptionNO: null
                  strDescriptionIL: null
                  strDescriptionPL: null
                  strGender: Male
                  strSide: ''
                  strPosition: Assistant Coach
                  strCollege: null
                  strFacebook: ''
                  strWebsite: ''
                  strTwitter: ''
                  strInstagram: ''
                  strYoutube: ''
                  strHeight: 1.72 m (5 ft 8 in)
                  strWeight: ''
                  intLoved: '0'
                  strThumb: https://r2.thesportsdb.com/images/media/player/thumb/ifh45x1767708245.jpg
                  strPoster: null
                  strCutout: https://r2.thesportsdb.com/images/media/player/cutout/1aq3m51767708263.png
                  strCartoon: null
                  strRender: null
                  strBanner: null
                  strFanart1: null
                  strFanart2: null
                  strFanart3: null
                  strFanart4: null
                  strCreativeCommons: 'No'
                  strCreativeCommonsAttribution: null
                  strLocked: unlocked
                  strLastName: Stuivenberg
                - idPlayer: '34163698'
                  idTeam: '133604'
                  idTeam2: null
                  idTeamNational: null
                  idAPIfootball: '19959'
                  idPlayerManager: null
                  idWikidata: Q27839155
                  idTransferMkt: '335721'
                  idESPN: '241077'
                  idGoogle: /g/11cpprmr81
                  strNationality: England
                  strPlayer: Ben White
                  strPlayerAlternate: Benjamin William White
                  strTeam: Arsenal
                  strTeam2: ''
                  strSport: Soccer
                  intSoccerXMLTeamID: null
                  dateBorn: '1997-11-08'
                  dateDied: null
                  strNumber: '4'
                  dateSigned: null
                  strSigning: £25.20m
                  strWage: £6,240,000
                  strOutfitter: ''
                  strKit: adidas X Speedportal
                  strAgent: ''
                  strBirthLocation: Poole, England
                  strDeathLocation: null
                  strEthnicity: White
                  strStatus: Active
                  strDescriptionEN: Benjamin William White (born 8 October 1997) is an English professional footballer who
                    plays as a centre-back for Premier League club Arsenal and the England…
                  strDescriptionDE: null
                  strDescriptionFR: null
                  strDescriptionCN: null
                  strDescriptionIT: null
                  strDescriptionJP: null
                  strDescriptionRU: null
                  strDescriptionES: null
                  strDescriptionPT: null
                  strDescriptionSE: null
                  strDescriptionNL: null
                  strDescriptionHU: null
                  strDescriptionNO: null
                  strDescriptionIL: null
                  strDescriptionPL: null
                  strGender: Male
                  strSide: Right
                  strPosition: Right-Back
                  strCollege: null
                  strFacebook: ''
                  strWebsite: ''
                  strTwitter: twitter.com/ben6white
                  strInstagram: www.instagram.com/ben_white6/
                  strYoutube: ''
                  strHeight: 186 cm
                  strWeight: 78 kg
                  intLoved: '1'
                  strThumb: https://r2.thesportsdb.com/images/media/player/thumb/5mnqcl1628887228.jpg
                  strPoster: null
                  strCutout: https://r2.thesportsdb.com/images/media/player/cutout/vwzzwn1788606671.png
                  strCartoon: https://r2.thesportsdb.com/images/media/player/cartoon/vkwp8e1769331944.png
                  strRender: https://r2.thesportsdb.com/images/media/player/render/grqsfp1628887196.png
                  strBanner: null
                  strFanart1: null
                  strFanart2: null
                  strFanart3: null
                  strFanart4: null
                  strCreativeCommons: 'Yes'
                  strCreativeCommonsAttribution: By James Boyes from UK - BHA v FC Nantes pre season 03 08 2018-34.jpg, CC
                    BY 2.0, https://commons.wikimedia.org/w/index.php?curid=97418040
                  strLocked: unlocked
                  strLastName: White
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/eventsnext.php:
    get:
      operationId: teamNextEvents
      tags:
      - Schedules
      summary: A team's next events
      description: |-
        Free keys: home games only.

        Records measured 5 Oct 2026: free key **1**, premium key **10**.

        Documented limit: 1 / 10 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The team id.
        schema:
          type: integer
        example: 133602
      responses:
        '200':
          description: The records under `events`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                events:
                - idEvent: '2494051'
                  idAPIfootball: '1557424'
                  strTimestamp: '2026-10-11T15:30:00'
                  strEvent: Liverpool vs Manchester City
                  strEventAlternate: Manchester City @ Liverpool
                  strFilename: English Premier League 2026-10-11 Liverpool vs Manchester City
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSeason: 2026-2027
                  strDescriptionEN: null
                  strHomeTeam: Liverpool
                  strAwayTeam: Manchester City
                  intHomeScore: null
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '6'
                  intAwayScore: null
                  intSpectators: null
                  strOfficial: ''
                  strWeather: null
                  dateEvent: '2026-10-11'
                  dateEventLocal: null
                  strTime: '15:30:00'
                  strTimeLocal: null
                  strGroup: null
                  idHomeTeam: '133602'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/kfaher1737969724.png
                  idAwayTeam: '133613'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/vwpvry1467462651.png
                  intScore: null
                  intScoreVotes: null
                  strResult: null
                  idVenue: '15407'
                  strVenue: Anfield
                  strCountry: England
                  strCity: null
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/56jjbh1784549629.jpg
                  strSquare: https://r2.thesportsdb.com/images/media/event/square/pcd1pu1784550174.jpg
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/4jalui1784549326.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/lf3lp61784549908.jpg
                  strMap: null
                  strTweet1: null
                  strVideo: null
                  strStatus: NS
                  strPostponed: 'no'
                  strLocked: unlocked
                - idEvent: '2594671'
                  idAPIfootball: '1635674'
                  strTimestamp: '2026-10-14T16:45:00'
                  strEvent: LASK vs Liverpool
                  strEventAlternate: Liverpool @ LASK
                  strFilename: UEFA Champions League 2026-10-14 LASK vs Liverpool
                  strSport: Soccer
                  idLeague: '4480'
                  strLeague: UEFA Champions League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/facv1u1742998896.png
                  strSeason: 2026-2027
                  strDescriptionEN: ''
                  strHomeTeam: LASK
                  strAwayTeam: Liverpool
                  intHomeScore: null
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '2'
                  intAwayScore: null
                  intSpectators: null
                  strOfficial: ''
                  strWeather: ''
                  dateEvent: '2026-10-14'
                  dateEventLocal: '2026-10-14'
                  strTime: '16:45:00'
                  strTimeLocal: ''
                  strGroup: ''
                  idHomeTeam: '137261'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/oox26l1683556395.png
                  idAwayTeam: '133602'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/kfaher1737969724.png
                  intScore: null
                  intScoreVotes: null
                  strResult: ''
                  idVenue: '18691'
                  strVenue: Raiffeisen Arena Linz
                  strCountry: Austria
                  strCity: ''
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/fxlzer1787915805.jpg
                  strSquare: ''
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/dazw0f1787915695.jpg
                  strBanner: ''
                  strMap: null
                  strTweet1: ''
                  strVideo: ''
                  strStatus: NS
                  strPostponed: 'no'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/eventslast.php:
    get:
      operationId: teamLastEvents
      tags:
      - Schedules
      summary: A team's last results
      description: |-
        Free keys: home games only. The record key is `results`, but the records are events.

        Records measured 5 Oct 2026: free key **1**, premium key **5**.

        Documented limit: 1 / 10 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The team id.
        schema:
          type: integer
        example: 133602
      responses:
        '200':
          description: The records under `results`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                results:
                - idEvent: '2494041'
                  idAPIfootball: '1557407'
                  strTimestamp: '2026-09-20T13:00:00'
                  strEvent: Bournemouth vs Liverpool
                  strEventAlternate: Liverpool @ Bournemouth
                  strFilename: English Premier League 2026-09-20 Bournemouth vs Liverpool
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSeason: 2026-2027
                  strDescriptionEN: ''
                  strHomeTeam: Bournemouth
                  strAwayTeam: Liverpool
                  intHomeScore: '0'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '5'
                  intAwayScore: '1'
                  intSpectators: null
                  strOfficial: ''
                  strWeather: ''
                  dateEvent: '2026-09-20'
                  dateEventLocal: '2026-09-20'
                  strTime: '13:00:00'
                  strTimeLocal: '14:00:00'
                  strGroup: ''
                  idHomeTeam: '134301'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/y08nak1534071116.png
                  idAwayTeam: '133602'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/kfaher1737969724.png
                  intScore: null
                  intScoreVotes: null
                  strResult: ''
                  idVenue: '16113'
                  strVenue: Vitality Stadium
                  strCountry: England
                  strCity: ''
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/yl6a0i1784549622.jpg
                  strSquare: https://r2.thesportsdb.com/images/media/event/square/a9slc31784550166.jpg
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/dn9pr91784549318.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/ursi1l1784549901.jpg
                  strMap: null
                  strTweet1: ''
                  strVideo: https://www.youtube.com/watch?v=IlmSPd_LxQI
                  strStatus: FT
                  strPostponed: 'no'
                  strLocked: unlocked
                - idEvent: '2594454'
                  idAPIfootball: '1635563'
                  strTimestamp: '2026-09-15T19:00:00'
                  strEvent: Liverpool vs Tottenham Hotspur
                  strEventAlternate: Tottenham Hotspur @ Liverpool
                  strFilename: EFL Cup 2026-09-15 Liverpool vs Tottenham Hotspur
                  strSport: Soccer
                  idLeague: '4570'
                  strLeague: EFL Cup
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/x1va771565372556.png
                  strSeason: 2026-2027
                  strDescriptionEN: ''
                  strHomeTeam: Liverpool
                  strAwayTeam: Tottenham Hotspur
                  intHomeScore: '3'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '32'
                  intAwayScore: '1'
                  intSpectators: null
                  strOfficial: ''
                  strWeather: ''
                  dateEvent: '2026-09-15'
                  dateEventLocal: '2026-09-15'
                  strTime: '19:00:00'
                  strTimeLocal: '20:00:00'
                  strGroup: ''
                  idHomeTeam: '133602'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/kfaher1737969724.png
                  idAwayTeam: '133616'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/dfyfhl1604094109.png
                  intScore: null
                  intScoreVotes: null
                  strResult: ''
                  idVenue: '15407'
                  strVenue: Anfield
                  strCountry: England
                  strCity: ''
                  strPoster: ''
                  strSquare: ''
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/x31a4g1788782656.jpg
                  strBanner: ''
                  strMap: null
                  strTweet1: ''
                  strVideo: https://www.youtube.com/watch?v=Z2EXAkCRtvY
                  strStatus: FT
                  strPostponed: 'no'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/eventsnextleague.php:
    get:
      operationId: leagueNextEvents
      tags:
      - Schedules
      summary: A league's next events
      description: |-
        Records measured 5 Oct 2026: free key **1**, premium key **20**.

        Documented limit: 1 / 20 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The league id.
        schema:
          type: integer
        example: 4328
      responses:
        '200':
          description: The records under `events`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                events:
                - idEvent: '2494052'
                  idAPIfootball: '1557417'
                  strTimestamp: '2026-10-10T11:30:00'
                  strEvent: Arsenal vs Leeds United
                  strEventAlternate: Leeds United @ Arsenal
                  strFilename: English Premier League 2026-10-10 Arsenal vs Leeds United
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSeason: 2026-2027
                  strDescriptionEN: null
                  strHomeTeam: Arsenal
                  strAwayTeam: Leeds United
                  intHomeScore: null
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '6'
                  intAwayScore: null
                  intSpectators: null
                  strOfficial: ''
                  strWeather: null
                  dateEvent: '2026-10-10'
                  dateEventLocal: null
                  strTime: '11:30:00'
                  strTimeLocal: null
                  strGroup: null
                  idHomeTeam: '133604'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png
                  idAwayTeam: '133635'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/jcgrml1756649030.png
                  intScore: null
                  intScoreVotes: null
                  strResult: null
                  idVenue: '15528'
                  strVenue: Emirates Stadium
                  strCountry: England
                  strCity: null
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/ekc9q71784549630.jpg
                  strSquare: https://r2.thesportsdb.com/images/media/event/square/kzqbsy1784550175.jpg
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/mayo9h1784549326.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/h61dc61784549908.jpg
                  strMap: null
                  strTweet1: null
                  strVideo: null
                  strStatus: NS
                  strPostponed: 'no'
                  strLocked: unlocked
                - idEvent: '2494053'
                  idAPIfootball: '1557419'
                  strTimestamp: '2026-10-10T14:00:00'
                  strEvent: Chelsea vs Bournemouth
                  strEventAlternate: Bournemouth @ Chelsea
                  strFilename: English Premier League 2026-10-10 Chelsea vs Bournemouth
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSeason: 2026-2027
                  strDescriptionEN: null
                  strHomeTeam: Chelsea
                  strAwayTeam: Bournemouth
                  intHomeScore: null
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '6'
                  intAwayScore: null
                  intSpectators: null
                  strOfficial: ''
                  strWeather: null
                  dateEvent: '2026-10-10'
                  dateEventLocal: null
                  strTime: '14:00:00'
                  strTimeLocal: null
                  strGroup: null
                  idHomeTeam: '133610'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/pbf4ul1782638263.png
                  idAwayTeam: '134301'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/y08nak1534071116.png
                  intScore: null
                  intScoreVotes: null
                  strResult: null
                  idVenue: '16126'
                  strVenue: Stamford Bridge
                  strCountry: England
                  strCity: null
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/xge61b1785931595.jpg
                  strSquare: https://r2.thesportsdb.com/images/media/event/square/pwlt9r1785931693.jpg
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/q8dbtn1785931536.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/sjpul21785931645.jpg
                  strMap: null
                  strTweet1: null
                  strVideo: null
                  strStatus: NS
                  strPostponed: 'no'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/eventspastleague.php:
    get:
      operationId: leaguePastEvents
      tags:
      - Schedules
      summary: A league's latest results
      description: |-
        Records measured 5 Oct 2026: free key **1**, premium key **15**.

        Documented limit: 1 / 20 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The league id.
        schema:
          type: integer
        example: 4328
      responses:
        '200':
          description: The records under `events`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                events:
                - idEvent: '2494042'
                  idAPIfootball: '1557411'
                  strTimestamp: '2026-09-20T15:30:00'
                  strEvent: Fulham vs Manchester United
                  strEventAlternate: Manchester United @ Fulham
                  strFilename: English Premier League 2026-09-20 Fulham vs Manchester United
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSeason: 2026-2027
                  strDescriptionEN: ''
                  strHomeTeam: Fulham
                  strAwayTeam: Manchester United
                  intHomeScore: '1'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '5'
                  intAwayScore: '1'
                  intSpectators: null
                  strOfficial: ''
                  strWeather: ''
                  dateEvent: '2026-09-20'
                  dateEventLocal: '2026-09-20'
                  strTime: '15:30:00'
                  strTimeLocal: '16:30:00'
                  strGroup: ''
                  idHomeTeam: '133600'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/xwwvyt1448811086.png
                  idAwayTeam: '133612'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/xzqdr11517660252.png
                  intScore: null
                  intScoreVotes: null
                  strResult: ''
                  idVenue: '16373'
                  strVenue: Craven Cottage
                  strCountry: England
                  strCity: ''
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/mwnm8a1784549623.jpg
                  strSquare: https://r2.thesportsdb.com/images/media/event/square/y9xp8c1784550167.jpg
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/yvirsk1784549319.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/1g2ieu1784549902.jpg
                  strMap: null
                  strTweet1: ''
                  strVideo: https://www.youtube.com/watch?v=Iw-n4AhB960
                  strStatus: FT
                  strPostponed: 'no'
                  strLocked: unlocked
                - idEvent: '2494048'
                  idAPIfootball: '1557412'
                  strTimestamp: '2026-09-20T13:00:00'
                  strEvent: Leeds United vs Crystal Palace
                  strEventAlternate: Crystal Palace @ Leeds United
                  strFilename: English Premier League 2026-09-20 Leeds United vs Crystal Palace
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSeason: 2026-2027
                  strDescriptionEN: ''
                  strHomeTeam: Leeds United
                  strAwayTeam: Crystal Palace
                  intHomeScore: '0'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '5'
                  intAwayScore: '0'
                  intSpectators: null
                  strOfficial: ''
                  strWeather: ''
                  dateEvent: '2026-09-20'
                  dateEventLocal: '2026-09-20'
                  strTime: '13:00:00'
                  strTimeLocal: '14:00:00'
                  strGroup: ''
                  idHomeTeam: '133635'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/jcgrml1756649030.png
                  idAwayTeam: '133632'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/ia6i3m1656014992.png
                  intScore: null
                  intScoreVotes: null
                  strResult: ''
                  idVenue: '15534'
                  strVenue: Elland Road
                  strCountry: England
                  strCity: ''
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/xetfpk1784549627.jpg
                  strSquare: https://r2.thesportsdb.com/images/media/event/square/xlcqbh1784550171.jpg
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/9rjviz1784549323.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/gookbi1784549906.jpg
                  strMap: null
                  strTweet1: ''
                  strVideo: https://www.youtube.com/watch?v=0py0BrSoADQ
                  strStatus: FT
                  strPostponed: 'no'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/eventsday.php:
    get:
      operationId: eventsOnDay
      tags:
      - Schedules
      summary: Every event on a day
      description: |-
        The day is a **UTC** date: evening games in the Americas appear on the next day. A day with no matching events returns `{"events":null}`.

        Records measured 5 Oct 2026: free key **3**, premium key **901**.

        Documented limit: 3 / 1500 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: d
        in: query
        required: true
        description: A day, `YYYY-MM-DD`. Events are filed under their **UTC** date.
        schema:
          type: string
          format: date
        example: '2026-10-04'
      - name: s
        in: query
        required: false
        description: Sport name.
        schema:
          type: string
        example: Ice_Hockey
      - name: l
        in: query
        required: false
        description: League id or name.
        schema:
          type: string
        example: '4328'
      responses:
        '200':
          description: The records under `events`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                events:
                - idEvent: '2475423'
                  idAPIfootball: '21562'
                  strTimestamp: '2026-10-04T13:30:00'
                  strEvent: Washington Commanders vs Indianapolis Colts
                  strEventAlternate: Indianapolis Colts @ Washington Commanders
                  strFilename: NFL 2026-10-04 Washington Commanders vs Indianapolis Colts
                  strSport: American Football
                  idLeague: '4391'
                  strLeague: NFL
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/g85fqz1662057187.png
                  strSeason: '2026'
                  strDescriptionEN: The Washington Commanders and Indianapolis Colts bring the NFL to London for a Week 4
                    matchup at Tottenham Hotspur Stadium, opening the league’s three-game r…
                  strHomeTeam: Washington Commanders
                  strAwayTeam: Indianapolis Colts
                  intHomeScore: '13'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '4'
                  intAwayScore: '30'
                  intSpectators: null
                  strOfficial: ''
                  strWeather: ''
                  dateEvent: '2026-10-04'
                  dateEventLocal: '2026-10-04'
                  strTime: '13:30:00'
                  strTimeLocal: '14:30:00'
                  strGroup: ''
                  idHomeTeam: '134937'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/rn0c7v1643826119.png
                  idAwayTeam: '134927'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/im99lm1784720368.png
                  intScore: null
                  intScoreVotes: null
                  strResult: ' Washington Commanders Quarter 1:<br>6 0 <br>Quarter 2<br>0 10 <br>Quarter 3<br>7 10 <br>Quarter
                    4<br>0 10 <br>Overtime<br> '
                  idVenue: '16118'
                  strVenue: Tottenham Hotspur Stadium
                  strCountry: United Kingdom
                  strCity: London
                  strPoster: ''
                  strSquare: ''
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/9sgyk31784759773.jpg
                  strBanner: ''
                  strMap: null
                  strTweet1: ''
                  strVideo: https://www.youtube.com/watch?v=VSkRsq4Tlfg
                  strStatus: FT
                  strPostponed: 'no'
                  strLocked: unlocked
                - idEvent: '2475424'
                  idAPIfootball: '21563'
                  strTimestamp: '2026-10-04T17:00:00'
                  strEvent: Buffalo Bills vs New England Patriots
                  strEventAlternate: New England Patriots @ Buffalo Bills
                  strFilename: NFL 2026-10-04 Buffalo Bills vs New England Patriots
                  strSport: American Football
                  idLeague: '4391'
                  strLeague: NFL
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/g85fqz1662057187.png
                  strSeason: '2026'
                  strDescriptionEN: ''
                  strHomeTeam: Buffalo Bills
                  strAwayTeam: New England Patriots
                  intHomeScore: '26'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '4'
                  intAwayScore: '29'
                  intSpectators: null
                  strOfficial: ''
                  strWeather: ''
                  dateEvent: '2026-10-04'
                  dateEventLocal: '2026-10-04'
                  strTime: '17:00:00'
                  strTimeLocal: '13:00:00'
                  strGroup: ''
                  idHomeTeam: '134918'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/j4r1tn1784714823.png
                  idAwayTeam: '134920'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/xtwxyt1421431860.png
                  intScore: null
                  intScoreVotes: null
                  strResult: ' Buffalo Bills Quarter 1:<br>0 7 <br>Quarter 2<br>17 7 <br>Quarter 3<br>0 7 <br>Quarter 4<br>9
                    8 <br>Overtime<br> '
                  idVenue: '33904'
                  strVenue: Highmark Stadium
                  strCountry: United States
                  strCity: Orchard Park, NY
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/j3nn6m1717017343.jpg
                  strSquare: https://r2.thesportsdb.com/images/media/event/square/ugx1f61659872680.jpg
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/9dn6fh1784759774.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/dsgcmm1659875412.jpg
                  strMap: null
                  strTweet1: ''
                  strVideo: https://www.youtube.com/watch?v=Z5zAM_GLGI0
                  strStatus: FT
                  strPostponed: 'no'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/eventsseason.php:
    get:
      operationId: seasonEvents
      tags:
      - Schedules
      summary: A league's whole season
      description: |-
        Fewer fields than a lookup (no descriptions, officials or spectators).

        Records measured 5 Oct 2026: free key **5**, premium key **380**.

        Documented limit: 15 / 3000 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The league id.
        schema:
          type: integer
        example: 4328
      - name: s
        in: query
        required: true
        description: Season name, from `strCurrentSeason`.
        schema:
          type: string
        example: 2026-2027
      responses:
        '200':
          description: The records under `events`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                events:
                - idEvent: '2494000'
                  strEvent: Arsenal vs Coventry City
                  strEventAlternate: Coventry City @ Arsenal
                  strSeason: 2026-2027
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSport: Soccer
                  strHomeTeam: Arsenal
                  strAwayTeam: Coventry City
                  idHomeTeam: '133604'
                  idAwayTeam: '133625'
                  intRound: '1'
                  intHomeScore: '3'
                  intAwayScore: '0'
                  strTimestamp: '2026-08-21T19:00:00'
                  dateEvent: '2026-08-21'
                  dateEventLocal: '2026-08-21'
                  strTime: '19:00:00'
                  strTimeLocal: '20:00:00'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/uxyqys1424033798.png
                  strVenue: Emirates Stadium
                  strCountry: England
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/yjiatn1784549286.jpg
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/dgng9j1784549593.jpg
                  strVideo: https://www.youtube.com/watch?v=J4334NsIoCs
                  strPostponed: 'no'
                  strFilename: English Premier League 2026-08-21 Arsenal vs Coventry City
                  strStatus: FT
                - idEvent: '2494001'
                  strEvent: Hull City vs Manchester United
                  strEventAlternate: Manchester United @ Hull City
                  strSeason: 2026-2027
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSport: Soccer
                  strHomeTeam: Hull City
                  strAwayTeam: Manchester United
                  idHomeTeam: '133617'
                  idAwayTeam: '133612'
                  intRound: '1'
                  intHomeScore: '2'
                  intAwayScore: '0'
                  strTimestamp: '2026-08-22T11:30:00'
                  dateEvent: '2026-08-22'
                  dateEventLocal: '2026-08-22'
                  strTime: '11:30:00'
                  strTimeLocal: '12:30:00'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/fbqqda1601726113.png
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/xzqdr11517660252.png
                  strVenue: The MKM Stadium
                  strCountry: England
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/876aok1784549287.jpg
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/mlxgn31784549594.jpg
                  strVideo: https://www.youtube.com/watch?v=xHYYKDFBPl4
                  strPostponed: 'no'
                  strFilename: English Premier League 2026-08-22 Hull City vs Manchester United
                  strStatus: FT
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/eventsround.php:
    get:
      operationId: roundEvents
      tags:
      - Schedules
      summary: One round of a season
      description: |-
        Returns the whole round. `l=` instead of `id=` returns `{"events":"Invalid League ID or no round passed"}`. With a premium key, filter v2 `schedule/league/{id}/{season}` by `intRound` instead.

        **Not in the official documentation.** Answers the free keys; **premium keys get HTTP 404**.

        Records measured 5 Oct 2026: free key **10**, premium key **HTTP 404**.
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: id
        in: query
        required: true
        description: The league id.
        schema:
          type: integer
        example: 4328
      - name: r
        in: query
        required: true
        description: Round (matchday) number.
        schema:
          type: integer
        example: 1
      - name: s
        in: query
        required: true
        description: Season name.
        schema:
          type: string
        example: 2026-2027
      responses:
        '200':
          description: The records under `events`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  events:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                events:
                - idEvent: '2494000'
                  idAPIfootball: '1557367'
                  strTimestamp: '2026-08-21T19:00:00'
                  strEvent: Arsenal vs Coventry City
                  strEventAlternate: Coventry City @ Arsenal
                  strFilename: English Premier League 2026-08-21 Arsenal vs Coventry City
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSeason: 2026-2027
                  strDescriptionEN: Reigning champions Arsenal host newly promoted Championship winners Coventry City at Emirates
                    Stadium to open the 2026–27 Premier League season.  The primary…
                  strHomeTeam: Arsenal
                  strAwayTeam: Coventry City
                  intHomeScore: '3'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '1'
                  intAwayScore: '0'
                  intSpectators: null
                  strOfficial: ''
                  strWeather: ''
                  dateEvent: '2026-08-21'
                  dateEventLocal: '2026-08-21'
                  strTime: '19:00:00'
                  strTimeLocal: '20:00:00'
                  strGroup: ''
                  idHomeTeam: '133604'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png
                  idAwayTeam: '133625'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/uxyqys1424033798.png
                  intScore: null
                  intScoreVotes: null
                  strResult: Arsenal kicked off their Premier League title defense with a comfortable 3–0 win over Coventry
                    City at Emirates Stadium. Kai Havertz opened the scoring in th…
                  idVenue: '15528'
                  strVenue: Emirates Stadium
                  strCountry: England
                  strCity: London
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/dgng9j1784549593.jpg
                  strSquare: https://r2.thesportsdb.com/images/media/event/square/ldcov31784550134.jpg
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/yjiatn1784549286.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/zmmkwr1784549873.jpg
                  strMap: null
                  strTweet1: ''
                  strVideo: https://www.youtube.com/watch?v=J4334NsIoCs
                  strStatus: FT
                  strPostponed: 'no'
                  strLocked: unlocked
                - idEvent: '2494001'
                  idAPIfootball: '1557368'
                  strTimestamp: '2026-08-22T11:30:00'
                  strEvent: Hull City vs Manchester United
                  strEventAlternate: Manchester United @ Hull City
                  strFilename: English Premier League 2026-08-22 Hull City vs Manchester United
                  strSport: Soccer
                  idLeague: '4328'
                  strLeague: English Premier League
                  strLeagueBadge: https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
                  strSeason: 2026-2027
                  strDescriptionEN: ''
                  strHomeTeam: Hull City
                  strAwayTeam: Manchester United
                  intHomeScore: '2'
                  intHomeScoreExtra: null
                  intAwayScoreExtra: null
                  intRound: '1'
                  intAwayScore: '0'
                  intSpectators: null
                  strOfficial: ''
                  strWeather: ''
                  dateEvent: '2026-08-22'
                  dateEventLocal: '2026-08-22'
                  strTime: '11:30:00'
                  strTimeLocal: '12:30:00'
                  strGroup: ''
                  idHomeTeam: '133617'
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/fbqqda1601726113.png
                  idAwayTeam: '133612'
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/xzqdr11517660252.png
                  intScore: null
                  intScoreVotes: null
                  strResult: ''
                  idVenue: '21620'
                  strVenue: The MKM Stadium
                  strCountry: England
                  strCity: ''
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/mlxgn31784549594.jpg
                  strSquare: https://r2.thesportsdb.com/images/media/event/square/xv66cl1784550135.jpg
                  strFanart: null
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/876aok1784549287.jpg
                  strBanner: https://r2.thesportsdb.com/images/media/event/banner/enue8g1784549874.jpg
                  strMap: null
                  strTweet1: ''
                  strVideo: https://www.youtube.com/watch?v=xHYYKDFBPl4
                  strStatus: FT
                  strPostponed: 'no'
                  strLocked: unlocked
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
        '404':
          description: Returned to premium keys (an HTML page).
      x-undocumented: true
      security: []
  /api/v1/json/{apiKey}/eventstv.php:
    get:
      operationId: tvListings
      tags:
      - TV
      summary: TV listings
      description: |-
        Use one form: `d` (optionally with `s`, or `s` and `a`), `c`, or `id`. **`a` without `s` returns an empty body.** For an event's channels use `lookuptv.php`.

        Records measured 5 Oct 2026: free key **1**, premium key **287**.

        Documented limit: 1 / 1500 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: d
        in: query
        required: false
        description: A day, `YYYY-MM-DD`.
        schema:
          type: string
          format: date
        example: '2026-10-05'
      - name: s
        in: query
        required: false
        description: Sport name (with `d`).
        schema:
          type: string
        example: Ice_Hockey
      - name: a
        in: query
        required: false
        description: Country of the channel (with `d` **and** `s`).
        schema:
          type: string
        example: Canada
      - name: c
        in: query
        required: false
        description: Channel name (alone), e.g. `TSN_1`.
        schema:
          type: string
        example: TSN_1
      - name: id
        in: query
        required: false
        description: Channel id, `idChannel` (alone). **Not** an event id.
        schema:
          type: integer
        example: 8631
      responses:
        '200':
          description: The records under `tvevents`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  tvevents:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/TvListing'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                tvevents:
                - id: '1225271'
                  idEvent: '2475436'
                  intDivision: '0'
                  strSport: American Football
                  strEvent: Carolina Panthers vs Detroit Lions
                  strEventThumb: https://r2.thesportsdb.com/images/media/event/thumb/0q02zg1784759794.jpg
                  strEventPoster: https://r2.thesportsdb.com/images/media/event/poster/t9nw851717018142.jpg
                  strEventBanner: https://r2.thesportsdb.com/images/media/event/banner/20e7mp1659875398.jpg
                  strEventSquare: https://r2.thesportsdb.com/images/media/event/square/11qxra1659872668.jpg
                  idChannel: '6692'
                  strCountry: Honduras
                  strEventCountry: United States
                  strLogo: https://r2.thesportsdb.com/images/media/channel/logo/7kjl921660761653.png
                  strChannel: ESPN 2 Honduras
                  strSeason: '2026'
                  strTime: 00:20:00
                  dateEvent: '2026-10-05'
                  strTimeStamp: '2026-10-05 00:20:00'
                - id: '1226738'
                  idEvent: '2475436'
                  intDivision: '0'
                  strSport: American Football
                  strEvent: Carolina Panthers vs Detroit Lions
                  strEventThumb: https://r2.thesportsdb.com/images/media/event/thumb/0q02zg1784759794.jpg
                  strEventPoster: https://r2.thesportsdb.com/images/media/event/poster/t9nw851717018142.jpg
                  strEventBanner: https://r2.thesportsdb.com/images/media/event/banner/20e7mp1659875398.jpg
                  strEventSquare: https://r2.thesportsdb.com/images/media/event/square/11qxra1659872668.jpg
                  idChannel: '8646'
                  strCountry: United Kingdom
                  strEventCountry: United States
                  strLogo: https://r2.thesportsdb.com/images/media/channel/logo/ub8szd1780683863.png
                  strChannel: Sky Sports Main Event
                  strSeason: '2026'
                  strTime: 00:20:00
                  dateEvent: '2026-10-05'
                  strTimeStamp: '2026-10-05 00:20:00'
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/eventshighlights.php:
    get:
      operationId: highlights
      tags:
      - Video
      summary: Events with highlight videos
      description: |-
        The video URL is in `strVideo`. Premium results stop at the documented 50.

        Records measured 5 Oct 2026: free key **2**, premium key **50**.

        Documented limit: 2 / 50 (free / premium).
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: d
        in: query
        required: true
        description: A day, `YYYY-MM-DD`. Events are filed under their **UTC** date.
        schema:
          type: string
          format: date
        example: '2026-10-04'
      - name: l
        in: query
        required: false
        description: League id.
        schema:
          type: integer
        example: 4328
      - name: s
        in: query
        required: false
        description: Sport name.
        schema:
          type: string
        example: Soccer
      responses:
        '200':
          description: The records under `tvhighlights`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  tvhighlights:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/Event'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                tvhighlights:
                - idEvent: '2360237'
                  strEvent: Alfred Dunhill Links Championship Final Round
                  strSport: Golf
                  idLeague: '4426'
                  strLeague: European Tour
                  strVideo: https://www.youtube.com/watch?v=4JoBr2RZwMs
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/il7pok1758804489.jpg
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/o3g75v1758804513.jpg
                  strFanart: https://www.thesportsdb.com/images/media/event/fanart/8561v71791195399.jpg
                  strSeason: '2026'
                - idEvent: '2389534'
                  strEvent: 'WRC Rally Italia Sardegna '
                  strSport: Motorsport
                  idLeague: '4409'
                  strLeague: WRC
                  strVideo: https://www.youtube.com/watch?v=2SXrweITJQg
                  strPoster: https://r2.thesportsdb.com/images/media/event/poster/l0c2ly1622662468.jpg
                  strThumb: https://r2.thesportsdb.com/images/media/event/thumb/eamc8r1622662489.jpg
                  strFanart: https://www.thesportsdb.com/images/media/event/fanart/sls3ka1791142084.jpg
                  strSeason: '2026'
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      security: []
  /api/v1/json/{apiKey}/livescore.php:
    get:
      operationId: liveScores
      tags:
      - Live scores
      summary: Games in progress
      description: |-
        The free keys get the full feed. `l=` (league) is **ignored**: every live game is returned. Entries can be stale; check `updated`. v2 `livescore/...` is the documented equivalent.

        **Not in the official documentation.**

        Records measured 5 Oct 2026: free key **19**, premium key **19**.
      parameters:
      - $ref: '#/components/parameters/apiKey'
      - name: s
        in: query
        required: true
        description: Sport name.
        schema:
          type: string
        example: Soccer
      responses:
        '200':
          description: The records under `livescore`. An empty body also means no results.
          content:
            application/json:
              schema:
                type: object
                properties:
                  livescore:
                    oneOf:
                    - type: array
                      items:
                        $ref: '#/components/schemas/LiveScore'
                    - type: 'null'
                      description: No results.
                    - type: string
                      description: A rejected parameter, e.g. `Invalid League ID passed`.
              example:
                livescore:
                - idLiveScore: '21525882'
                  idEvent: '2542667'
                  strSport: Soccer
                  idLeague: '4647'
                  strLeague: English Isthmian League Premier Division
                  intDivision: '7'
                  idHomeTeam: '137933'
                  idAwayTeam: '136008'
                  strHomeTeam: Carshalton Athletic
                  strAwayTeam: Eastbourne Borough
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/nvf4kc1729184702.png
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/bb5j121689076508.png
                  intHomeScore: '0'
                  intAwayScore: '1'
                  strStatus: 1H
                  strProgress: '20'
                  strTimestamp: '2026-10-05T18:45:00'
                  strEventTime: '18:45'
                  dateEvent: '2026-10-05'
                  updated: '2026-10-05 20:07:31'
                - idLiveScore: '21525847'
                  idEvent: '2442810'
                  strSport: Soccer
                  idLeague: '4490'
                  strLeague: UEFA Nations League
                  intDivision: '99'
                  idHomeTeam: '133915'
                  idAwayTeam: '135987'
                  strHomeTeam: Ukraine
                  strAwayTeam: Hungary
                  strHomeTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/k36g2e1591982718.png
                  strAwayTeamBadge: https://r2.thesportsdb.com/images/media/team/badge/ihaoit1717365719.png
                  intHomeScore: '0'
                  intAwayScore: '0'
                  strStatus: 1H
                  strProgress: '21'
                  strTimestamp: '2026-10-05T18:45:00'
                  strEventTime: '18:45'
                  dateEvent: '2026-10-05'
                  updated: '2026-10-05 20:07:31'
        '400':
          $ref: '#/components/responses/InvalidKey'
        '429':
          $ref: '#/components/responses/RateLimited'
      x-undocumented: true
      security: []
components:
  schemas:
    Contract:
      type: object
      description: Contract record. Every value is a string or null; `""` also means no value.
      properties:
        id:
          type:
          - string
          - 'null'
          description: Id of this contract record.
          examples:
          - '112'
        idPlayer:
          type:
          - string
          - 'null'
          description: Player id.
          examples:
          - '34147178'
        idTeam:
          type:
          - string
          - 'null'
          description: Team id.
          examples:
          - '134281'
        strBadge:
          type:
          - string
          - 'null'
          description: Badge image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/team/badge/yprvxx1473538097.png
        strPlayer:
          type:
          - string
          - 'null'
          description: Player name.
          examples:
          - Edenilson
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strTeam:
          type:
          - string
          - 'null'
          description: Team name.
          examples:
          - Internacional
        strWage:
          type:
          - string
          - 'null'
          description: Wage, as text with currency, e.g. `£5,200,000`.
        strYearEnd:
          type:
          - string
          - 'null'
          description: Contract end year.
          examples:
          - '2021'
        strYearStart:
          type:
          - string
          - 'null'
          description: Contract start year.
          examples:
          - '2018'
    Country:
      type: object
      description: Country record. Every value is a string or null; `""` also means no value.
      properties:
        flag_url_32:
          type:
          - string
          - 'null'
          description: 32 px flag image URL.
          examples:
          - https://www.thesportsdb.com/images/icons/flags/shiny/32/Andorra.png
        name_en:
          type:
          - string
          - 'null'
          description: Country name in English. Use this spelling for country filters.
          examples:
          - Andorra
    Equipment:
      type: object
      description: Equipment record. Every value is a string or null; `""` also means no value.
      properties:
        date:
          type:
          - string
          - 'null'
          description: When the kit was added, `YYYY-MM-DD HH:MM:SS` (zone not stated).
          examples:
          - '2019-08-16 13:22:58'
        idEquipment:
          type:
          - string
          - 'null'
          description: Id of this kit record.
          examples:
          - '612'
        idTeam:
          type:
          - string
          - 'null'
          description: Id of the team the kit belongs to.
          examples:
          - '133597'
        strEquipment:
          type:
          - string
          - 'null'
          description: Kit image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/team/equipment/2019-133597-Jersey.png
        strSeason:
          type:
          - string
          - 'null'
          description: Season name, e.g. `2026-2027`, or `2026` for single-year leagues.
          examples:
          - 2019-2020
        strType:
          type:
          - string
          - 'null'
          description: Kit type, e.g. `1st`, `2nd`, `GK`.
          examples:
          - 1st
        strUsername:
          type:
          - string
          - 'null'
          description: TheSportsDB user who uploaded the record (or the artwork).
          examples:
          - smudgie
    Event:
      type: object
      description: Event record. Every value is a string or null; `""` also means no value.
      properties:
        dateEvent:
          type:
          - string
          - 'null'
          description: Date of the event, `YYYY-MM-DD`, in **UTC**.
          examples:
          - '2026-09-06'
        dateEventLocal:
          type:
          - string
          - 'null'
          description: Date of the event at the venue, `YYYY-MM-DD`. Often missing for future events.
          examples:
          - '2026-09-06'
        idAPIfootball:
          type:
          - string
          - 'null'
          description: Id of the same record in API-Football.
          examples:
          - '1557387'
        idAwayTeam:
          type:
          - string
          - 'null'
          description: Away team id.
          examples:
          - '133610'
        idEvent:
          type:
          - string
          - 'null'
          description: Event id.
          examples:
          - '2494022'
        idHomeTeam:
          type:
          - string
          - 'null'
          description: Home team id.
          examples:
          - '133604'
        idLeague:
          type:
          - string
          - 'null'
          description: League id.
          examples:
          - '4328'
        idVenue:
          type:
          - string
          - 'null'
          description: Venue id.
          examples:
          - '15528'
        intAwayScore:
          type:
          - string
          - 'null'
          description: Away score. Null until the event has a score.
          examples:
          - '1'
        intAwayScoreExtra:
          type:
          - string
          - 'null'
          description: Away score in extra time or a shoot-out.
        intHomeScore:
          type:
          - string
          - 'null'
          description: Home score. Null until the event has a score.
          examples:
          - '2'
        intHomeScoreExtra:
          type:
          - string
          - 'null'
          description: Home score in extra time or a shoot-out.
        intRound:
          type:
          - string
          - 'null'
          description: 'Round or matchday number, or a stage code: 125 quarter-final, 150 semi-final, 160 playoff, 170 playoff
            semi-final, 180 playoff final, 200 final, 400 qualifier, 500 pre-season.'
          examples:
          - '3'
        intScore:
          type:
          - string
          - 'null'
          description: Users' rating of the event.
          examples:
          - '8'
        intScoreVotes:
          type:
          - string
          - 'null'
          description: Number of ratings.
          examples:
          - '1'
        intSpectators:
          type:
          - string
          - 'null'
          description: Attendance.
          examples:
          - '60026'
        strAwayTeam:
          type:
          - string
          - 'null'
          description: Away team name.
          examples:
          - Chelsea
        strAwayTeamBadge:
          type:
          - string
          - 'null'
          description: Away team's badge.
          examples:
          - https://r2.thesportsdb.com/images/media/team/badge/pbf4ul1782638263.png
        strBanner:
          type:
          - string
          - 'null'
          description: Banner image URL (wide).
          examples:
          - https://r2.thesportsdb.com/images/media/event/banner/m3ktrt1785931642.jpg
        strCity:
          type:
          - string
          - 'null'
          description: City where the event takes place.
          examples:
          - Liverpool
        strCountry:
          type:
          - string
          - 'null'
          description: Country where the event takes place.
          examples:
          - England
        strDescriptionEN:
          type:
          - string
          - 'null'
          description: Description in language `EN`.
          examples:
          - Defending champions Arsenal welcome Chelsea to the Emirates Stadium for an early-season London derby between two
            sides that have started the Premier League c…
        strEvent:
          type:
          - string
          - 'null'
          description: Event name, usually `Home vs Away`.
          examples:
          - Arsenal vs Chelsea
        strEventAlternate:
          type:
          - string
          - 'null'
          description: Alternate event name, usually `Away @ Home`.
          examples:
          - Chelsea @ Arsenal
        strFanart:
          type:
          - string
          - 'null'
          description: Fan art image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/event/fanart/yrsrvp1444121673.jpg
        strFilename:
          type:
          - string
          - 'null'
          description: '`{League} {YYYY-MM-DD} {Home} vs {Away}`: searchable with `searchfilename.php`.'
          examples:
          - English Premier League 2026-09-06 Arsenal vs Chelsea
        strGroup:
          type:
          - string
          - 'null'
          description: Group or conference within a competition.
          examples:
          - B4
        strHomeTeam:
          type:
          - string
          - 'null'
          description: Home team name.
          examples:
          - Arsenal
        strHomeTeamBadge:
          type:
          - string
          - 'null'
          description: Home team's badge.
          examples:
          - https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png
        strLeague:
          type:
          - string
          - 'null'
          description: League name.
          examples:
          - English Premier League
        strLeagueBadge:
          type:
          - string
          - 'null'
          description: The league's badge.
          examples:
          - https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
        strLocked:
          type:
          - string
          - 'null'
          description: '`locked` or `unlocked`: whether the record is protected from edits.'
          examples:
          - unlocked
        strMap:
          type:
          - string
          - 'null'
          description: Either coordinates as `latitude, longitude`, or a map image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/event/map/qypvvt1444121357.jpg
        strOfficial:
          type:
          - string
          - 'null'
          description: The referee or main official.
        strPoster:
          type:
          - string
          - 'null'
          description: Poster image URL (tall).
          examples:
          - https://r2.thesportsdb.com/images/media/event/poster/0l3uib1785931591.jpg
        strPostponed:
          type:
          - string
          - 'null'
          description: '`yes` or `no`.'
          examples:
          - 'no'
        strResult:
          type:
          - string
          - 'null'
          description: Result as free text; can contain HTML (`<br>`).
          examples:
          - Arsenal recovered from conceding after just 77 seconds to defeat Chelsea 2–1 and preserve their perfect start
            to the Premier League season. Morgan Rogers gav…
        strSeason:
          type:
          - string
          - 'null'
          description: Season name, e.g. `2026-2027`, or `2026` for single-year leagues.
          examples:
          - 2026-2027
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strSquare:
          type:
          - string
          - 'null'
          description: Square image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/event/square/xgqyzb1785931689.jpg
        strStatus:
          type:
          - string
          - 'null'
          description: Status code, e.g. `NS` (not started), `1H`, `HT`, `2H`, `FT`, `Q3`, `P2`, `S1` (set), `PST`/`POST`
            (postponed), `SUSP`/`INT` (interrupted), `CANC`, `ABD`. Codes differ by sport. Older events often have none.
          examples:
          - FT
        strThumb:
          type:
          - string
          - 'null'
          description: Thumbnail for the event.
          examples:
          - https://r2.thesportsdb.com/images/media/event/thumb/uxuamm1785931532.jpg
        strTime:
          type:
          - string
          - 'null'
          description: Start time, `HH:MM:SS`, in **UTC**.
          examples:
          - '15:30:00'
        strTimeLocal:
          type:
          - string
          - 'null'
          description: Start time at the venue, `HH:MM:SS`. Often missing for future events.
          examples:
          - '16:30:00'
        strTimestamp:
          type:
          - string
          - 'null'
          description: Start, `YYYY-MM-DDTHH:MM:SS`, in **UTC** (no zone in the text).
          examples:
          - '2026-09-06T15:30:00'
        strTweet1:
          type:
          - string
          - 'null'
          description: A tweet about the event.
          examples:
          - https://twitter.com/premierleague/status/1429493773860487169
        strVenue:
          type:
          - string
          - 'null'
          description: Venue name.
          examples:
          - Emirates Stadium
        strVideo:
          type:
          - string
          - 'null'
          description: Highlights video URL, usually YouTube.
          examples:
          - https://www.youtube.com/watch?v=af99CJ4f_yc
        strWeather:
          type:
          - string
          - 'null'
          description: Weather at the event.
          examples:
          - Heavy Rain
    EventResult:
      type: object
      description: EventResult record. Every value is a string or null; `""` also means no value.
      properties:
        dateEvent:
          type:
          - string
          - 'null'
          description: Date of the event, `YYYY-MM-DD`, in **UTC**.
          examples:
          - '2022-07-17'
        idEvent:
          type:
          - string
          - 'null'
          description: Event id.
          examples:
          - '1392219'
        idPlayer:
          type:
          - string
          - 'null'
          description: Player id.
          examples:
          - '34160573'
        idResult:
          type:
          - string
          - 'null'
          description: Id of this result record.
          examples:
          - '21890'
        idTeam:
          type:
          - string
          - 'null'
          description: Team id.
          examples:
          - '134826'
        intPoints:
          type:
          - string
          - 'null'
          description: Points.
          examples:
          - '0'
        intPosition:
          type:
          - string
          - 'null'
          description: Finishing position.
          examples:
          - '4'
        strCountry:
          type:
          - string
          - 'null'
          description: Country.
          examples:
          - United Kingdom
        strDetail:
          type:
          - string
          - 'null'
          description: Extra result detail, e.g. a time gap such as `+29.520`.
          examples:
          - + 3.631
        strEvent:
          type:
          - string
          - 'null'
          description: Event name, usually `Home vs Away`.
          examples:
          - New York City E Prix Race 2
        strPlayer:
          type:
          - string
          - 'null'
          description: Player name.
          examples:
          - Alexander Sims
        strResult:
          type:
          - string
          - 'null'
          description: Result as free text; can contain HTML (`<br>`).
        strSeason:
          type:
          - string
          - 'null'
          description: Season name, e.g. `2026-2027`, or `2026` for single-year leagues.
          examples:
          - 2021-2022
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Motorsport
    EventStat:
      type: object
      description: EventStat record. Every value is a string or null; `""` also means no value.
      properties:
        idApiFootball:
          type:
          - string
          - 'null'
          description: Id of the same record in API-Football (note the different capitalisation on this record type).
          examples:
          - '592172'
        idEvent:
          type:
          - string
          - 'null'
          description: Event id.
          examples:
          - '1032723'
        idStatistic:
          type:
          - string
          - 'null'
          description: Id of this statistic.
          examples:
          - '17'
        intAway:
          type:
          - string
          - 'null'
          description: The statistic for the away side.
          examples:
          - '8'
        intHome:
          type:
          - string
          - 'null'
          description: The statistic for the home side.
          examples:
          - '11'
        strEvent:
          type:
          - string
          - 'null'
          description: Event name, usually `Home vs Away`.
          examples:
          - Aston Villa vs Liverpool
        strStat:
          type:
          - string
          - 'null'
          description: Name of the team statistic, e.g. `Shots on Goal`, `Ball Possession`.
          examples:
          - Shots on Goal
    FormerTeam:
      type: object
      description: FormerTeam record. Every value is a string or null; `""` also means no value.
      properties:
        id:
          type:
          - string
          - 'null'
          description: Id of this former-team record.
          examples:
          - '11819'
        idFormerTeam:
          type:
          - string
          - 'null'
          description: Team id of the former team.
          examples:
          - '134284'
        idPlayer:
          type:
          - string
          - 'null'
          description: Player id.
          examples:
          - '34147178'
        intAppearances:
          type:
          - string
          - 'null'
          description: Appearances for the team.
        intGoals:
          type:
          - string
          - 'null'
          description: Goals for the team.
        strBadge:
          type:
          - string
          - 'null'
          description: Badge image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/team/badge/vvuvps1473538042.png
        strDeparted:
          type:
          - string
          - 'null'
          description: When the player left, usually a year.
          examples:
          - '2014'
        strFormerTeam:
          type:
          - string
          - 'null'
          description: Name of the former team.
          examples:
          - Corinthians
        strJoined:
          type:
          - string
          - 'null'
          description: When the player joined, usually a year.
          examples:
          - '2011'
        strMoveType:
          type:
          - string
          - 'null'
          description: How the player moved, e.g. `Permanent`, `Loan`.
          examples:
          - Permanent
        strPlayer:
          type:
          - string
          - 'null'
          description: Player name.
          examples:
          - Edenilson
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
    Honour:
      type: object
      description: Honour record. Every value is a string or null; `""` also means no value.
      properties:
        id:
          type:
          - string
          - 'null'
          description: Id of this player's honour record (see `idHonour` for the honour itself).
          examples:
          - '11211'
        idHonour:
          type:
          - string
          - 'null'
          description: Id of the honour (trophy or award) itself, shared by everyone who won it.
          examples:
          - '749'
        idLeague:
          type:
          - string
          - 'null'
          description: League id.
          examples:
          - '4351'
        idPlayer:
          type:
          - string
          - 'null'
          description: Player id.
          examples:
          - '34147178'
        idTeam:
          type:
          - string
          - 'null'
          description: Team id.
          examples:
          - '134284'
        strHonour:
          type:
          - string
          - 'null'
          description: Name of the honour, e.g. `Copa Libertadores`.
          examples:
          - Brazilian Brasileirao
        strHonourLogo:
          type:
          - string
          - 'null'
          description: Logo of the honour.
          examples:
          - https://www.thesportsdb.com/images/media/honour/logo/mxhjar1650460067.png
        strHonourTrophy:
          type:
          - string
          - 'null'
          description: Image of the honour's trophy.
          examples:
          - https://www.thesportsdb.com/images/media/honour/trophy/xzspl21650460217.png
        strPlayer:
          type:
          - string
          - 'null'
          description: Player name.
          examples:
          - Edenilson
        strSeason:
          type:
          - string
          - 'null'
          description: Season name, e.g. `2026-2027`, or `2026` for single-year leagues.
          examples:
          - '2011'
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strTeam:
          type:
          - string
          - 'null'
          description: Team name.
          examples:
          - Corinthians
        strTeamBadge:
          type:
          - string
          - 'null'
          description: Badge of the team.
          examples:
          - https://r2.thesportsdb.com/images/media/team/badge/vvuvps1473538042.png
    League:
      type: object
      description: League record. Every value is a string or null; `""` also means no value.
      properties:
        dateFirstEvent:
          type:
          - string
          - 'null'
          description: Date of the league's first recorded event.
          examples:
          - '1992-08-15'
        idAPIfootball:
          type:
          - string
          - 'null'
          description: Id of the same record in API-Football.
          examples:
          - '8346'
        idAPIfootballv3:
          type:
          - string
          - 'null'
          description: Id of the same league in API-Football v3.
          examples:
          - '39'
        idCup:
          type:
          - string
          - 'null'
          description: '`1` for a cup competition, `0` for a league.'
          examples:
          - '0'
        idLeague:
          type:
          - string
          - 'null'
          description: League id.
          examples:
          - '4328'
        intDivision:
          type:
          - string
          - 'null'
          description: Division level; `1` is a top flight. Cups often use `0` or `99`.
          examples:
          - '0'
        intFormedYear:
          type:
          - string
          - 'null'
          description: Year founded. `0` means unknown.
          examples:
          - '1992'
        strBadge:
          type:
          - string
          - 'null'
          description: Badge image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png
        strBanner:
          type:
          - string
          - 'null'
          description: Banner image URL (wide).
          examples:
          - https://r2.thesportsdb.com/images/media/league/banner/xe1es51638921786.jpg
        strComplete:
          type:
          - string
          - 'null'
          description: Whether TheSportsDB considers the league's data complete (`yes`/`No`).
          examples:
          - 'yes'
        strCountry:
          type:
          - string
          - 'null'
          description: Country.
          examples:
          - England
        strCurrentSeason:
          type:
          - string
          - 'null'
          description: The league's current season name. Pass it to the season endpoints.
          examples:
          - 2026-2027
        strDescriptionCN:
          type:
          - string
          - 'null'
          description: Description in language `CN`.
          examples:
          - "英格兰足球超级联赛（英语：Premier League），简称英超，過往冠名為巴克萊超級聯賽（Barclays Premier League），是英格蘭足球總會轄下的职业足球联赛，是英格蘭聯賽系統的最高等级联赛，英超由超级联盟负责具体运作，而運作模式為一所以20間球會共同擁有的有限公司。\r\
            \n英格兰超级联赛成立於1…"
        strDescriptionDE:
          type:
          - string
          - 'null'
          description: Description in language `DE`.
          examples:
          - Die Premier League (offiziell nach dem Sponsoren „Barclays Premier League“, umgangssprachlich „The Premiership“)
            ist die höchste Spielklasse im englischen Fu…
        strDescriptionEN:
          type:
          - string
          - 'null'
          description: Description in language `EN`.
          examples:
          - 'The Premier League, often referred to as the English Premier League or the EPL (legal name: The Football Association
            Premier League Limited), is the top leve…'
        strDescriptionES:
          type:
          - string
          - 'null'
          description: Description in language `ES`.
          examples:
          - La Premier League, también conocida en el Reino Unido como The Premiership, es la máxima categoría del sistema
            de Ligas de fútbol de Inglaterra. Comenzó a di…
        strDescriptionFR:
          type:
          - string
          - 'null'
          description: Description in language `FR`.
          examples:
          - Le Championnat d'Angleterre de football est une compétition sportive située au sommet de la hiérarchie du football
            en Angleterre. Lancée en 1888 par la The F…
        strDescriptionHU:
          type:
          - string
          - 'null'
          description: Description in language `HU`.
          examples:
          - A Premier League (más néven Premiership vagy Barclays Premier League) az angol labdarúgó bajnokságok legfelsőbb
            osztályának elnevezése. Ez a világ legnézette…
        strDescriptionIL:
          type:
          - string
          - 'null'
          description: Description in language `IL`.
          examples:
          - ע"א פרמייר ליג (The FA Premier League) נגד המועצה להסדר ההימורים בספורט[1] הוא פסק דין של בית המשפט העליון שניתן
            בשנת 2010. עיקר המחלוקת נסובה סביב רצונן של …
        strDescriptionIT:
          type:
          - string
          - 'null'
          description: Description in language `IT`.
          examples:
          - "La Premier League è la massima serie del campionato inglese di calcio ed è gestita dalla Football Association\
            \ (FA).\r\n\r\nSi tratta di un campionato formato da …"
        strDescriptionJP:
          type:
          - string
          - 'null'
          description: Description in language `JP`.
          examples:
          - "プレミアリーグ（英: Premier League）は、イングランドのサッカーリーグにおけるトップディヴィジョン（1部リーグ）。[1]\r\n\r\n世界中で約10億人以上に視聴され、全世界で最も人気が高いリーグであり[2]、世界最高峰レベルのリーグの一つである。サッカー競技のみならず、全世界のスポーツリーグの中で最もテ…"
        strDescriptionNL:
          type:
          - string
          - 'null'
          description: Description in language `NL`.
          examples:
          - "De Premier League is de hoogste Engelse voetbalcompetitie.\r\n\r\nDe competitie bestaat uit twintig clubs die\
            \ tussen augustus en mei in totaal 380 wedstrijden sp…"
        strDescriptionNO:
          type:
          - string
          - 'null'
          description: Description in language `NO`.
          examples:
          - Premier League er den engelske toppserien i fotball. Premier League er på toppen av ligasystemet i engelsk fotball,
            og består av 20 lag, som operer med syste…
        strDescriptionPL:
          type:
          - string
          - 'null'
          description: Description in language `PL`.
          examples:
          - Premier League (nazywana także English Premier League) – zawodowa liga piłkarska znajdująca się na najwyższym
            szczeblu rozgrywek piłkarskich w Anglii. Gra w …
        strDescriptionPT:
          type:
          - string
          - 'null'
          description: Description in language `PT`.
          examples:
          - Premier League é uma liga profissional de futebol da Inglaterra e está no topo do sistema de ligas do futebol
            inglês, sendo a principal competição de futebol…
        strDescriptionRU:
          type:
          - string
          - 'null'
          description: Description in language `RU`.
          examples:
          - Премье́р-лига (англ. Premier League) — профессиональная футбольная лига для английских футбольных клубов (также
            в ней могут играть некоторые клубы из Уэльса[…
        strDescriptionSE:
          type:
          - string
          - 'null'
          description: Description in language `SE`.
          examples:
          - "Premier League, 1992–2007 benämnd FA Premier League, är en engelsk fotbollsliga, grundad 1992, som är den högsta\
            \ divisionen i det engelska ligasystemet.\r\n\r\n2…"
        strFacebook:
          type:
          - string
          - 'null'
          description: Facebook page, often without a scheme.
          examples:
          - xen-gb.facebook.com/premierleague/
        strFanart1:
          type:
          - string
          - 'null'
          description: Fan art image 1.
          examples:
          - https://r2.thesportsdb.com/images/media/league/fanart/odberp1725731801.jpg
        strFanart2:
          type:
          - string
          - 'null'
          description: Fan art image 2.
          examples:
          - https://r2.thesportsdb.com/images/media/league/fanart/s0ozu31725731959.jpg
        strFanart3:
          type:
          - string
          - 'null'
          description: Fan art image 3.
          examples:
          - https://r2.thesportsdb.com/images/media/league/fanart/44vpk61725732073.jpg
        strFanart4:
          type:
          - string
          - 'null'
          description: Fan art image 4.
          examples:
          - https://r2.thesportsdb.com/images/media/league/fanart/grmbt01725731922.jpg
        strGender:
          type:
          - string
          - 'null'
          description: '`Male` or `Female`.'
          examples:
          - Male
        strInstagram:
          type:
          - string
          - 'null'
          description: Instagram profile, often without a scheme.
          examples:
          - www.instagram.com/premierleague
        strLeague:
          type:
          - string
          - 'null'
          description: League name.
          examples:
          - English Premier League
        strLeagueAlternate:
          type:
          - string
          - 'null'
          description: Other names for the league, comma-separated.
          examples:
          - Premier League, EPL, England
        strLocked:
          type:
          - string
          - 'null'
          description: '`locked` or `unlocked`: whether the record is protected from edits.'
          examples:
          - unlocked
        strLogo:
          type:
          - string
          - 'null'
          description: Logo image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/league/logo/4c377s1535214890.png
        strNaming:
          type:
          - string
          - 'null'
          description: Template for event names, e.g. `{strHomeTeam} vs {strAwayTeam}`.
          examples:
          - '{strHomeTeam} vs {strAwayTeam}'
        strPoster:
          type:
          - string
          - 'null'
          description: Poster image URL (tall).
          examples:
          - https://r2.thesportsdb.com/images/media/league/poster/67al0l1719007596.jpg
        strRSS:
          type:
          - string
          - 'null'
          description: RSS feed URL.
          examples:
          - https://feeds.bbci.co.uk/sport/football/rss.xml
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strTrophy:
          type:
          - string
          - 'null'
          description: Image of the league's trophy.
          examples:
          - https://r2.thesportsdb.com/images/media/league/trophy/9a6kw51689108793.png
        strTvRights:
          type:
          - string
          - 'null'
          description: Broadcasting rights holders, as free text.
          examples:
          - "Australia - Stan \r\nCanada - FuboTV [2022-2025]\r\nCarribean - Verticast [2022-2025] \r\nHong Kong - Now TV\
            \ [2022-2025]\r\nIndia - Star Sports [2022-2025]\r\nIndonesi…"
        strTwitter:
          type:
          - string
          - 'null'
          description: Twitter/X profile, often without a scheme.
          examples:
          - twitter.com/premierleague
        strWebsite:
          type:
          - string
          - 'null'
          description: Website, often without a scheme (`www.arsenal.com`).
          examples:
          - www.premierleague.com
        strYoutube:
          type:
          - string
          - 'null'
          description: YouTube channel, often without a scheme.
          examples:
          - www.youtube.com/channel/UCG5qGWdu8nIRZqJ_GgDwQ-w
    LineupEntry:
      type: object
      description: LineupEntry record. Every value is a string or null; `""` also means no value.
      properties:
        idEvent:
          type:
          - string
          - 'null'
          description: Event id.
          examples:
          - '1032723'
        idLineup:
          type:
          - string
          - 'null'
          description: Id of this lineup record.
          examples:
          - '541'
        idPlayer:
          type:
          - string
          - 'null'
          description: Player id.
          examples:
          - '34145423'
        idTeam:
          type:
          - string
          - 'null'
          description: Team id.
          examples:
          - '133601'
        intSquadNumber:
          type:
          - string
          - 'null'
          description: Squad number.
          examples:
          - '26'
        strCutout:
          type:
          - string
          - 'null'
          description: Transparent head-and-shoulders image of the player.
          examples:
          - https://r2.thesportsdb.com/images/media/player/cutout/ffr5xx1756984715.png
        strHome:
          type:
          - string
          - 'null'
          description: '`Yes` for the home side, `No` for the away side.'
          examples:
          - 'Yes'
        strPlayer:
          type:
          - string
          - 'null'
          description: Player name.
          examples:
          - Emiliano Martinez
        strPosition:
          type:
          - string
          - 'null'
          description: Playing position, e.g. `Goalkeeper`, `Centre-Forward`.
          examples:
          - Goalkeeper
        strRender:
          type:
          - string
          - 'null'
          description: Transparent full-body image of the player.
          examples:
          - https://r2.thesportsdb.com/images/media/player/render/2zw8zq1693647864.png
        strSubstitute:
          type:
          - string
          - 'null'
          description: '`Yes` for a substitute, `No` for a starter.'
          examples:
          - 'No'
        strTeam:
          type:
          - string
          - 'null'
          description: Team name.
          examples:
          - Aston Villa
        strThumb:
          type:
          - string
          - 'null'
          description: Thumbnail image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/player/thumb/7drp311770201331.jpg
    LiveScore:
      type: object
      description: LiveScore record. Every value is a string or null; `""` also means no value.
      properties:
        dateEvent:
          type:
          - string
          - 'null'
          description: Date of the event, `YYYY-MM-DD`, in **UTC**.
          examples:
          - '2026-10-05'
        idAwayTeam:
          type:
          - string
          - 'null'
          description: Away team id.
          examples:
          - '136008'
        idEvent:
          type:
          - string
          - 'null'
          description: Event id.
          examples:
          - '2542667'
        idHomeTeam:
          type:
          - string
          - 'null'
          description: Home team id.
          examples:
          - '137933'
        idLeague:
          type:
          - string
          - 'null'
          description: League id.
          examples:
          - '4647'
        idLiveScore:
          type:
          - string
          - 'null'
          description: Id of this live-score record.
          examples:
          - '21525882'
        intAwayScore:
          type:
          - string
          - 'null'
          description: Away score. Null until the event has a score.
          examples:
          - '1'
        intDivision:
          type:
          - string
          - 'null'
          description: Division level; `1` is a top flight. Cups often use `0` or `99`.
          examples:
          - '7'
        intHomeScore:
          type:
          - string
          - 'null'
          description: Home score. Null until the event has a score.
          examples:
          - '0'
        strAwayTeam:
          type:
          - string
          - 'null'
          description: Away team name.
          examples:
          - Eastbourne Borough
        strAwayTeamBadge:
          type:
          - string
          - 'null'
          description: Away team's badge.
          examples:
          - https://r2.thesportsdb.com/images/media/team/badge/bb5j121689076508.png
        strEventTime:
          type:
          - string
          - 'null'
          description: Kick-off time, `HH:MM`.
          examples:
          - '18:45'
        strHomeTeam:
          type:
          - string
          - 'null'
          description: Home team name.
          examples:
          - Carshalton Athletic
        strHomeTeamBadge:
          type:
          - string
          - 'null'
          description: Home team's badge.
          examples:
          - https://r2.thesportsdb.com/images/media/team/badge/nvf4kc1729184702.png
        strLeague:
          type:
          - string
          - 'null'
          description: League name.
          examples:
          - English Isthmian League Premier Division
        strProgress:
          type:
          - string
          - 'null'
          description: Progress of a live game, e.g. the minute, or `Final`.
          examples:
          - '20'
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strStatus:
          type:
          - string
          - 'null'
          description: Status code, e.g. `NS` (not started), `1H`, `HT`, `2H`, `FT`, `Q3`, `P2`, `S1` (set), `PST`/`POST`
            (postponed), `SUSP`/`INT` (interrupted), `CANC`, `ABD`. Codes differ by sport. Older events often have none.
          examples:
          - 1H
        strTimestamp:
          type:
          - string
          - 'null'
          description: Start, `YYYY-MM-DDTHH:MM:SS`, in **UTC** (no zone in the text).
          examples:
          - '2026-10-05T18:45:00'
        updated:
          type:
          - string
          - 'null'
          description: When the live score was last refreshed, `YYYY-MM-DD HH:MM:SS` (zone not stated). Old values mean a
            stale entry.
          examples:
          - '2026-10-05 20:07:31'
    Milestone:
      type: object
      description: Milestone record. Every value is a string or null; `""` also means no value.
      properties:
        dateMilestone:
          type:
          - string
          - 'null'
          description: Date of the milestone.
          examples:
          - '2022-09-07'
        id:
          type:
          - string
          - 'null'
          description: Id of this milestone record.
          examples:
          - '455'
        idMilestone:
          type:
          - string
          - 'null'
          description: Id of the milestone type.
          examples:
          - '1745'
        idPlayer:
          type:
          - string
          - 'null'
          description: Player id.
          examples:
          - '34161397'
        idTeam:
          type:
          - string
          - 'null'
          description: Team id.
          examples:
          - '133616'
        strMilestone:
          type:
          - string
          - 'null'
          description: Name of the milestone or award.
          examples:
          - UEFA Champions League Player Of The Match
        strMilestoneLogo:
          type:
          - string
          - 'null'
          description: Logo of the milestone.
          examples:
          - https://www.thesportsdb.com/images/media/milestone/logo/6230tq1662537994.png
        strPlayer:
          type:
          - string
          - 'null'
          description: Player name.
          examples:
          - Richarlison
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strTeam:
          type:
          - string
          - 'null'
          description: Team name.
          examples:
          - Tottenham
    Player:
      type: object
      description: Player record. Every value is a string or null; `""` also means no value.
      properties:
        dateBorn:
          type:
          - string
          - 'null'
          description: Date of birth, `YYYY-MM-DD`.
          examples:
          - '1990-11-26'
        dateDied:
          type:
          - string
          - 'null'
          description: Date of death, `YYYY-MM-DD`.
        dateSigned:
          type:
          - string
          - 'null'
          description: Date the player signed for the current team.
          examples:
          - '2014-08-25'
        idAPIfootball:
          type:
          - string
          - 'null'
          description: Id of the same record in API-Football.
          examples:
          - '1917'
        idESPN:
          type:
          - string
          - 'null'
          description: Id of the same record at ESPN.
          examples:
          - '100681'
        idGoogle:
          type:
          - string
          - 'null'
          description: Google Knowledge Graph id, e.g. `/g/11cpprmr81`.
          examples:
          - /g/11cpprmr81
        idPlayer:
          type:
          - string
          - 'null'
          description: Player id.
          examples:
          - '34145395'
        idPlayerManager:
          type:
          - string
          - 'null'
          description: Id of this person's record as a manager, when they also have one.
          examples:
          - '43001238'
        idTeam:
          type:
          - string
          - 'null'
          description: Id of the player's current team (club).
          examples:
          - '133610'
        idTeam2:
          type:
          - string
          - 'null'
          description: Id of the player's second team, often a national team.
          examples:
          - '134496'
        idTeamNational:
          type:
          - string
          - 'null'
          description: Id of the player's national team.
        idTransferMkt:
          type:
          - string
          - 'null'
          description: Transfermarkt id.
          examples:
          - '45146'
        idWikidata:
          type:
          - string
          - 'null'
          description: Wikidata id, e.g. `Q9144353`.
          examples:
          - Q129700
        intLoved:
          type:
          - string
          - 'null'
          description: Number of users who marked this as a favourite.
          examples:
          - '0'
        intSoccerXMLTeamID:
          type:
          - string
          - 'null'
          description: Id in the SoccerXML feed.
          examples:
          - '6'
        relevance:
          type:
          - string
          - 'null'
          description: Search relevance score (`searchplayers.php` only).
          examples:
          - '30.170034408569336'
        strAgent:
          type:
          - string
          - 'null'
          description: The player's agent.
          examples:
          - Bertolucci Sports
        strBanner:
          type:
          - string
          - 'null'
          description: Banner image URL (wide).
          examples:
          - https://r2.thesportsdb.com/images/media/player/banner/14xnnt1702986424.jpg
        strBirthLocation:
          type:
          - string
          - 'null'
          description: Place of birth.
          examples:
          - Palermo, Italy
        strCartoon:
          type:
          - string
          - 'null'
          description: Cartoon image of the player.
          examples:
          - https://r2.thesportsdb.com/images/media/player/cartoon/vkwp8e1769331944.png
        strCollege:
          type:
          - string
          - 'null'
          description: College attended.
        strCreativeCommons:
          type:
          - string
          - 'null'
          description: Whether the artwork is Creative Commons (`Yes`/`No`/`NO`). Artwork that isn't may not be used in published
            apps.
          examples:
          - 'Yes'
        strCreativeCommonsAttribution:
          type:
          - string
          - 'null'
          description: Credit line to show with Creative Commons artwork.
          examples:
          - By Amirhosseinnakhaeii - Own work, CC0, https://commons.wikimedia.org/w/index.php?curid=190437150
        strCutout:
          type:
          - string
          - 'null'
          description: Transparent head-and-shoulders image of the player.
          examples:
          - https://r2.thesportsdb.com/images/media/player/cutout/mjo6g31787690678.png
        strDeathLocation:
          type:
          - string
          - 'null'
          description: Place of death.
        strDescriptionCN:
          type:
          - string
          - 'null'
          description: Description in language `CN`.
        strDescriptionDE:
          type:
          - string
          - 'null'
          description: Description in language `DE`.
        strDescriptionEN:
          type:
          - string
          - 'null'
          description: Description in language `EN`.
          examples:
          - Mario Balotelli Barwuah (né Barwuah; born 12 August 1990) is an Italian professional footballer who plays as a
            striker for UAE First Division club Al-Ittifaq…
        strDescriptionES:
          type:
          - string
          - 'null'
          description: Description in language `ES`.
          examples:
          - Martin Ødegaard (n. Drammen, Noruega, 17 de diciembre de 1998) es un futbolista noruego que juega de centrocampista
            en el Real Madrid Castilla Club de Fútbol…
        strDescriptionFR:
          type:
          - string
          - 'null'
          description: Description in language `FR`.
        strDescriptionHU:
          type:
          - string
          - 'null'
          description: Description in language `HU`.
        strDescriptionIL:
          type:
          - string
          - 'null'
          description: Description in language `IL`.
        strDescriptionIT:
          type:
          - string
          - 'null'
          description: Description in language `IT`.
          examples:
          - Jurriën David Norman Timber, noto semplicemente come Jurriën Timber (Utrecht, 17 giugno 2001), è un calciatore
            olandese, difensore dell'Ajax.
        strDescriptionJP:
          type:
          - string
          - 'null'
          description: Description in language `JP`.
        strDescriptionNL:
          type:
          - string
          - 'null'
          description: Description in language `NL`.
        strDescriptionNO:
          type:
          - string
          - 'null'
          description: Description in language `NO`.
        strDescriptionPL:
          type:
          - string
          - 'null'
          description: Description in language `PL`.
        strDescriptionPT:
          type:
          - string
          - 'null'
          description: Description in language `PT`.
        strDescriptionRU:
          type:
          - string
          - 'null'
          description: Description in language `RU`.
        strDescriptionSE:
          type:
          - string
          - 'null'
          description: Description in language `SE`.
        strEthnicity:
          type:
          - string
          - 'null'
          description: Ethnicity, as given by contributors.
          examples:
          - Black
        strFacebook:
          type:
          - string
          - 'null'
          description: Facebook page, often without a scheme.
          examples:
          - www.facebook.com/MarioOfficialBalotelli
        strFanart1:
          type:
          - string
          - 'null'
          description: Fan art image 1.
          examples:
          - https://r2.thesportsdb.com/images/media/player/fanart/wwtsqs1431622222.jpg
        strFanart2:
          type:
          - string
          - 'null'
          description: Fan art image 2.
          examples:
          - https://r2.thesportsdb.com/images/media/player/fanart/upxsxy1431622235.jpg
        strFanart3:
          type:
          - string
          - 'null'
          description: Fan art image 3.
          examples:
          - https://r2.thesportsdb.com/images/media/player/fanart/vxqsyv1431622253.jpg
        strFanart4:
          type:
          - string
          - 'null'
          description: Fan art image 4.
          examples:
          - https://r2.thesportsdb.com/images/media/player/fanart/tvxuyq1431622269.jpg
        strGender:
          type:
          - string
          - 'null'
          description: '`Male` or `Female`.'
          examples:
          - Male
        strHeight:
          type:
          - string
          - 'null'
          description: Height as text, in mixed units, e.g. `1.82 m (6 ft 0 in)` or `186 cm`.
          examples:
          - 189 cm
        strInstagram:
          type:
          - string
          - 'null'
          description: Instagram profile, often without a scheme.
          examples:
          - instagram.com/mb459
        strKit:
          type:
          - string
          - 'null'
          description: Boot or equipment model the player wears.
          examples:
          - adidas X Speedportal
        strLastName:
          type:
          - string
          - 'null'
          description: The player's last name.
          examples:
          - Balotelli
        strLocked:
          type:
          - string
          - 'null'
          description: '`locked` or `unlocked`: whether the record is protected from edits.'
          examples:
          - unlocked
        strNationality:
          type:
          - string
          - 'null'
          description: The player's nationality.
          examples:
          - England
        strNumber:
          type:
          - string
          - 'null'
          description: Shirt number, as text.
          examples:
          - '9'
        strOutfitter:
          type:
          - string
          - 'null'
          description: Kit outfitter.
        strPlayer:
          type:
          - string
          - 'null'
          description: Player name.
          examples:
          - Danny Welbeck
        strPlayerAlternate:
          type:
          - string
          - 'null'
          description: The player's full or alternate name.
          examples:
          - Mario Balotelli Barwuah
        strPosition:
          type:
          - string
          - 'null'
          description: Playing position, e.g. `Goalkeeper`, `Centre-Forward`.
          examples:
          - Centre-Forward
        strPoster:
          type:
          - string
          - 'null'
          description: Poster image URL (tall).
          examples:
          - https://r2.thesportsdb.com/images/media/player/poster/suyvaf1749155864.jpg
        strRender:
          type:
          - string
          - 'null'
          description: Transparent full-body image of the player.
          examples:
          - https://r2.thesportsdb.com/images/media/player/render/sz8mu61654253818.png
        strSide:
          type:
          - string
          - 'null'
          description: Preferred foot or hand, `Left` or `Right`.
          examples:
          - Right
        strSigning:
          type:
          - string
          - 'null'
          description: Transfer fee, as text, e.g. `£25.20m` or `Youth`.
          examples:
          - £25.20m
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strStatus:
          type:
          - string
          - 'null'
          description: The player's status, e.g. `Active`, `Retired`.
          examples:
          - Active
        strTeam:
          type:
          - string
          - 'null'
          description: Name of the player's current team.
          examples:
          - Chelsea
        strTeam2:
          type:
          - string
          - 'null'
          description: Name of the player's second team, often a national team.
          examples:
          - Brazil
        strThumb:
          type:
          - string
          - 'null'
          description: Photo of the player.
          examples:
          - https://r2.thesportsdb.com/images/media/player/thumb/f5sgpu1772017716.jpg
        strTwitter:
          type:
          - string
          - 'null'
          description: Twitter/X profile, often without a scheme.
          examples:
          - twitter.com/finallymario
        strWage:
          type:
          - string
          - 'null'
          description: Wage, as text with currency, e.g. `£5,200,000`.
          examples:
          - £6,240,000
        strWebsite:
          type:
          - string
          - 'null'
          description: Website, often without a scheme (`www.arsenal.com`).
        strWeight:
          type:
          - string
          - 'null'
          description: Weight as text, in mixed units, e.g. `78 kg` or `161 lbs`.
          examples:
          - 192 lbs
        strYoutube:
          type:
          - string
          - 'null'
          description: YouTube channel, often without a scheme.
    PlayerStat:
      type: object
      description: PlayerStat record. Every value is a string or null; `""` also means no value.
      properties:
        id:
          type:
          - string
          - 'null'
          description: Id of this statistic record.
          examples:
          - '5321'
        idLeague:
          type:
          - string
          - 'null'
          description: League id.
          examples:
          - '4502'
        idPlayer:
          type:
          - string
          - 'null'
          description: Player id.
          examples:
          - '34146304'
        idTeam:
          type:
          - string
          - 'null'
          description: Team id.
          examples:
          - '133908'
        strLeague:
          type:
          - string
          - 'null'
          description: League name.
          examples:
          - European Championships
        strLeagueBadge:
          type:
          - string
          - 'null'
          description: The league's badge.
          examples:
          - https://r2.thesportsdb.com/images/media/league/badge/el53xu1551733974.png
        strPlayer:
          type:
          - string
          - 'null'
          description: Player name.
          examples:
          - Cristiano Ronaldo
        strSeason:
          type:
          - string
          - 'null'
          description: Season name, e.g. `2026-2027`, or `2026` for single-year leagues.
          examples:
          - '2004'
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strStatistic:
          type:
          - string
          - 'null'
          description: Name of the statistic, e.g. `Goals`, `Appearances`, `Mins Played`.
          examples:
          - Appearances
        strTeam:
          type:
          - string
          - 'null'
          description: Team name.
          examples:
          - Portugal
        strTeamBadge:
          type:
          - string
          - 'null'
          description: Badge of the team.
          examples:
          - https://r2.thesportsdb.com/images/media/team/badge/swqvpy1455466083.png
        strValue:
          type:
          - string
          - 'null'
          description: Value of the statistic, as text.
          examples:
          - '6'
    Season:
      type: object
      description: Season record. Every value is a string or null; `""` also means no value.
      properties:
        strSeason:
          type:
          - string
          - 'null'
          description: Season name, e.g. `2026-2027`, or `2026` for single-year leagues.
          examples:
          - 1992-1993
    Sport:
      type: object
      description: Sport record. Every value is a string or null; `""` also means no value.
      properties:
        idSport:
          type:
          - string
          - 'null'
          description: Sport id.
          examples:
          - '102'
        strFormat:
          type:
          - string
          - 'null'
          description: '`TeamvsTeam` (two sides) or `EventSport` (a field of competitors, e.g. motorsport, golf).'
          examples:
          - TeamvsTeam
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strSportDescription:
          type:
          - string
          - 'null'
          description: Description of the sport, in English.
          examples:
          - Association football, more commonly known as football or soccer, is a team sport played between two teams of eleven
            players with a spherical ball. It is play…
        strSportIconGreen:
          type:
          - string
          - 'null'
          description: Green icon for the sport.
          examples:
          - https://www.thesportsdb.com/images/icons/sports/soccer.png
        strSportThumb:
          type:
          - string
          - 'null'
          description: Image for the sport.
          examples:
          - https://www.thesportsdb.com/images/sports/soccer.jpg
        strSportThumbBW:
          type:
          - string
          - 'null'
          description: Black-and-white image for the sport.
          examples:
          - https://www.thesportsdb.com/images/sports/bw/soccer.jpg
    Standing:
      type: object
      description: Standing record. Every value is a string or null; `""` also means no value.
      properties:
        dateUpdated:
          type:
          - string
          - 'null'
          description: When the table row was last updated, `YYYY-MM-DD HH:MM:SS` (zone not stated).
          examples:
          - '2026-09-24 10:00:07'
        idLeague:
          type:
          - string
          - 'null'
          description: League id.
          examples:
          - '4328'
        idStanding:
          type:
          - string
          - 'null'
          description: Id of this table row.
          examples:
          - '9873035'
        idTeam:
          type:
          - string
          - 'null'
          description: Team id.
          examples:
          - '133613'
        intDraw:
          type:
          - string
          - 'null'
          description: Games drawn.
          examples:
          - '0'
        intGoalDifference:
          type:
          - string
          - 'null'
          description: Goal difference.
          examples:
          - '8'
        intGoalsAgainst:
          type:
          - string
          - 'null'
          description: Goals conceded.
          examples:
          - '5'
        intGoalsFor:
          type:
          - string
          - 'null'
          description: Goals scored.
          examples:
          - '13'
        intLoss:
          type:
          - string
          - 'null'
          description: Games lost.
          examples:
          - '0'
        intPlayed:
          type:
          - string
          - 'null'
          description: Games played.
          examples:
          - '5'
        intPoints:
          type:
          - string
          - 'null'
          description: Points.
          examples:
          - '15'
        intRank:
          type:
          - string
          - 'null'
          description: Position in the table.
          examples:
          - '1'
        intWin:
          type:
          - string
          - 'null'
          description: Games won.
          examples:
          - '5'
        strBadge:
          type:
          - string
          - 'null'
          description: Badge image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/team/badge/vwpvry1467462651.png/tiny
        strDescription:
          type:
          - string
          - 'null'
          description: What finishing in this position leads to, e.g. `Promotion - Champions League (League phase)`.
          examples:
          - Promotion - Champions League (League phase)
        strForm:
          type:
          - string
          - 'null'
          description: Recent results, newest last, e.g. `WWDLW`.
          examples:
          - WWWWW
        strGroup:
          type:
          - string
          - 'null'
          description: Group or conference within a competition.
          examples:
          - Premier League
        strLeague:
          type:
          - string
          - 'null'
          description: League name.
          examples:
          - English Premier League
        strSeason:
          type:
          - string
          - 'null'
          description: Season name, e.g. `2026-2027`, or `2026` for single-year leagues.
          examples:
          - 2026-2027
        strTeam:
          type:
          - string
          - 'null'
          description: Team name.
          examples:
          - Manchester City
    Team:
      type: object
      description: Team record. Every value is a string or null; `""` also means no value.
      properties:
        idAPIfootball:
          type:
          - string
          - 'null'
          description: Id of the same record in API-Football.
          examples:
          - '42'
        idESPN:
          type:
          - string
          - 'null'
          description: Id of the same record at ESPN.
          examples:
          - '359'
        idLeague:
          type:
          - string
          - 'null'
          description: Id of the team's main league. Other competitions are in `idLeague2`–`idLeague7`.
          examples:
          - '4328'
        idLeague2:
          type:
          - string
          - 'null'
          description: Id of the team's league or cup number 2.
          examples:
          - '4482'
        idLeague3:
          type:
          - string
          - 'null'
          description: Id of the team's league or cup number 3.
          examples:
          - '4570'
        idLeague4:
          type:
          - string
          - 'null'
          description: Id of the team's league or cup number 4.
          examples:
          - '4480'
        idLeague5:
          type:
          - string
          - 'null'
          description: Id of the team's league or cup number 5.
          examples:
          - '5648'
        idLeague6:
          type:
          - string
          - 'null'
          description: Id of the team's league or cup number 6.
          examples:
          - '4569'
        idLeague7:
          type:
          - string
          - 'null'
          description: Id of the team's league or cup number 7.
          examples:
          - '4571'
        idTeam:
          type:
          - string
          - 'null'
          description: Team id.
          examples:
          - '133604'
        idVenue:
          type:
          - string
          - 'null'
          description: Id of the team's home venue.
          examples:
          - '15528'
        intFormedYear:
          type:
          - string
          - 'null'
          description: Year founded. `0` means unknown.
          examples:
          - '1892'
        intLoved:
          type:
          - string
          - 'null'
          description: Number of users who marked this as a favourite.
          examples:
          - '10'
        strBadge:
          type:
          - string
          - 'null'
          description: Badge image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/team/badge/uyhbfe1612467038.png
        strBanner:
          type:
          - string
          - 'null'
          description: Banner image URL (wide).
          examples:
          - https://r2.thesportsdb.com/images/media/team/banner/ecl7mi1790192440.jpg
        strColour1:
          type:
          - string
          - 'null'
          description: Colour 1, hex like `#EF0107`.
          examples:
          - '#EF0107'
        strColour2:
          type:
          - string
          - 'null'
          description: Colour 2, hex like `#EF0107`.
          examples:
          - '#fbffff'
        strColour3:
          type:
          - string
          - 'null'
          description: Colour 3, hex like `#EF0107`.
          examples:
          - '#013373'
        strCountry:
          type:
          - string
          - 'null'
          description: Country.
          examples:
          - England
        strDescriptionCN:
          type:
          - string
          - 'null'
          description: Description in language `CN`.
        strDescriptionDE:
          type:
          - string
          - 'null'
          description: Description in language `DE`.
          examples:
          - 'Der FC Arsenal (offiziell: Arsenal Football Club) – auch bekannt als (The) Arsenal, (The) Gunners (deutsche Übersetzung:
            „Schützen“ oder „Kanoniere“) oder im…'
        strDescriptionEN:
          type:
          - string
          - 'null'
          description: Description in language `EN`.
          examples:
          - Arsenal Football Club is a professional football club based in Islington, London, England, that plays in the Premier
            League, the top flight of English footba…
        strDescriptionES:
          type:
          - string
          - 'null'
          description: Description in language `ES`.
          examples:
          - 'El Arsenal Football Club (pronunciación en inglés: /ˈɑː(ɹ)sənəl ˈfʊtˌbɔl klʌb/) es un club de fútbol profesional
            con sede en Holloway, Londres, Inglaterra, q…'
        strDescriptionFR:
          type:
          - string
          - 'null'
          description: Description in language `FR`.
          examples:
          - "Arsenal Football Club est un club de football anglais fondé le 1er décembre 1886 à Londres. Son siège est situé\
            \ dans le borough londonien d'Islington.\r\n\r\nArs…"
        strDescriptionHU:
          type:
          - string
          - 'null'
          description: Description in language `HU`.
        strDescriptionIL:
          type:
          - string
          - 'null'
          description: Description in language `IL`.
        strDescriptionIT:
          type:
          - string
          - 'null'
          description: Description in language `IT`.
          examples:
          - L'Arsenal Football Club, noto semplicemente come Arsenal, è una società calcistica inglese con sede a Londra,
            più precisamente nel quartiere di Holloway, nel…
        strDescriptionJP:
          type:
          - string
          - 'null'
          description: Description in language `JP`.
          examples:
          - "アーセナル・フットボール・クラブ（Arsenal Football Club、イギリス英語発音: [ˈɑːsənl ˈfutˌbɔːl klʌb]）は、イングランドの首都ロンドン北部をホームタウンとする、イングランドプロサッカーリーグ（プレミアリーグ）に加盟するプロサッカークラブ。クラブカラーは赤と白。\r\
            \n\r\n現…"
        strDescriptionNL:
          type:
          - string
          - 'null'
          description: Description in language `NL`.
        strDescriptionNO:
          type:
          - string
          - 'null'
          description: Description in language `NO`.
          examples:
          - Arsenal Football Club er en engelsk fotballklubb som spiller i Premier League. Klubben ble stiftet i 1886, og
            ble valgt inn i The Football League i 1893. «Th…
        strDescriptionPL:
          type:
          - string
          - 'null'
          description: Description in language `PL`.
        strDescriptionPT:
          type:
          - string
          - 'null'
          description: Description in language `PT`.
          examples:
          - "Arsenal Football Club é um clube de futebol, fundado e baseado em Londres, capital da Inglaterra.\r\n\r\nO clube\
            \ disputa a Premier League e é um dos mais bem suc…"
        strDescriptionRU:
          type:
          - string
          - 'null'
          description: Description in language `RU`.
          examples:
          - '«Арсена́л» (официальное полное название — Футбольный клуб «Арсенал», англ. Arsenal Football Club, английское
            произношение: [ˈɑrsənəl ''futbɔ:l klʌb]) — англий…'
        strDescriptionSE:
          type:
          - string
          - 'null'
          description: Description in language `SE`.
        strDivision:
          type:
          - string
          - 'null'
          description: The team's division, as text.
        strEquipment:
          type:
          - string
          - 'null'
          description: The team's current kit image.
          examples:
          - https://r2.thesportsdb.com/images/media/team/equipment/fwav4f1752100996.png
        strFacebook:
          type:
          - string
          - 'null'
          description: Facebook page, often without a scheme.
          examples:
          - www.facebook.com/Arsenal
        strFanart1:
          type:
          - string
          - 'null'
          description: Fan art image 1.
          examples:
          - https://r2.thesportsdb.com/images/media/team/fanart/ouqjzl1769332470.jpg
        strFanart2:
          type:
          - string
          - 'null'
          description: Fan art image 2.
          examples:
          - https://r2.thesportsdb.com/images/media/team/fanart/db23ct1769332477.jpg
        strFanart3:
          type:
          - string
          - 'null'
          description: Fan art image 3.
          examples:
          - https://r2.thesportsdb.com/images/media/team/fanart/k3r9od1769332483.jpg
        strFanart4:
          type:
          - string
          - 'null'
          description: Fan art image 4.
          examples:
          - https://r2.thesportsdb.com/images/media/team/fanart/2uvo8p1731313907.jpg
        strGender:
          type:
          - string
          - 'null'
          description: '`Male` or `Female`.'
          examples:
          - Male
        strInstagram:
          type:
          - string
          - 'null'
          description: Instagram profile, often without a scheme.
          examples:
          - instagram.com/arsenal
        strKeywords:
          type:
          - string
          - 'null'
          description: Nicknames and keywords, comma-separated, e.g. `Gunners, Gooners`.
          examples:
          - Gunners, Gooners
        strLeague:
          type:
          - string
          - 'null'
          description: Name of the team's main league.
          examples:
          - English Premier League
        strLeague2:
          type:
          - string
          - 'null'
          description: Name of the team's league or cup number 2.
          examples:
          - FA Cup
        strLeague3:
          type:
          - string
          - 'null'
          description: Name of the team's league or cup number 3.
          examples:
          - EFL Cup
        strLeague4:
          type:
          - string
          - 'null'
          description: Name of the team's league or cup number 4.
          examples:
          - UEFA Champions League
        strLeague5:
          type:
          - string
          - 'null'
          description: Name of the team's league or cup number 5.
          examples:
          - Emirates Cup
        strLeague6:
          type:
          - string
          - 'null'
          description: Name of the team's league or cup number 6.
          examples:
          - Club Friendlies
        strLeague7:
          type:
          - string
          - 'null'
          description: Name of the team's league or cup number 7.
          examples:
          - FA Community Shield
        strLocation:
          type:
          - string
          - 'null'
          description: Location, e.g. `Holloway, London, England`.
          examples:
          - Holloway, London, England
        strLocked:
          type:
          - string
          - 'null'
          description: '`locked` or `unlocked`: whether the record is protected from edits.'
          examples:
          - unlocked
        strLogo:
          type:
          - string
          - 'null'
          description: Logo image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/team/logo/q2mxlz1512644512.png
        strRSS:
          type:
          - string
          - 'null'
          description: RSS feed URL.
          examples:
          - http://www.football365.com/aston-villa/rss
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strStadium:
          type:
          - string
          - 'null'
          description: Name of the team's home stadium.
          examples:
          - Emirates Stadium
        strTeam:
          type:
          - string
          - 'null'
          description: Team name.
          examples:
          - Arsenal
        strTeamAlternate:
          type:
          - string
          - 'null'
          description: Other names for the team, comma-separated, e.g. `Arsenal Football Club, AFC, Arsenal FC`.
          examples:
          - Arsenal Football Club, AFC, Arsenal FC
        strTeamShort:
          type:
          - string
          - 'null'
          description: Short code, e.g. `ARS`.
          examples:
          - ARS
        strTwitter:
          type:
          - string
          - 'null'
          description: Twitter/X profile, often without a scheme.
          examples:
          - twitter.com/arsenal
        strWebsite:
          type:
          - string
          - 'null'
          description: Website, often without a scheme (`www.arsenal.com`).
          examples:
          - www.arsenal.com
        strYoutube:
          type:
          - string
          - 'null'
          description: YouTube channel, often without a scheme.
          examples:
          - www.youtube.com/user/ArsenalTour
    TimelineEntry:
      type: object
      description: TimelineEntry record. Every value is a string or null; `""` also means no value.
      properties:
        dateEvent:
          type:
          - string
          - 'null'
          description: Date of the event, `YYYY-MM-DD`, in **UTC**.
          examples:
          - '2020-09-27'
        idAPIfootball:
          type:
          - string
          - 'null'
          description: Id of the same record in API-Football.
          examples:
          - '592167'
        idAssist:
          type:
          - string
          - 'null'
          description: Player id of the assisting player.
          examples:
          - '34149736'
        idEvent:
          type:
          - string
          - 'null'
          description: Event id.
          examples:
          - '1032718'
        idPlayer:
          type:
          - string
          - 'null'
          description: Player id.
          examples:
          - '34147877'
        idTeam:
          type:
          - string
          - 'null'
          description: Team id.
          examples:
          - '133635'
        idTimeline:
          type:
          - string
          - 'null'
          description: Id of this timeline entry.
          examples:
          - '871243'
        intTime:
          type:
          - string
          - 'null'
          description: Minute of the timeline entry.
          examples:
          - '6'
        strAssist:
          type:
          - string
          - 'null'
          description: Name of the assisting player.
          examples:
          - Rodrigo Moreno Machado
        strComment:
          type:
          - string
          - 'null'
          description: Commentary for this timeline entry.
        strCutout:
          type:
          - string
          - 'null'
          description: Transparent head-and-shoulders image of the player.
        strEvent:
          type:
          - string
          - 'null'
          description: Event name, usually `Home vs Away`.
          examples:
          - Sheffield United vs Leeds
        strHome:
          type:
          - string
          - 'null'
          description: '`Yes` for the home side, `No` for the away side.'
          examples:
          - 'No'
        strPeriod:
          type:
          - string
          - 'null'
          description: Period of play.
        strPlayer:
          type:
          - string
          - 'null'
          description: Player name.
          examples:
          - Kalvin Phillips
        strSeason:
          type:
          - string
          - 'null'
          description: Season name, e.g. `2026-2027`, or `2026` for single-year leagues.
          examples:
          - 2020-2021
        strTeam:
          type:
          - string
          - 'null'
          description: Team name.
          examples:
          - Leeds
        strTimeline:
          type:
          - string
          - 'null'
          description: Kind of timeline entry, e.g. `Goal`, `Card`, `subst`.
          examples:
          - Card
        strTimelineDetail:
          type:
          - string
          - 'null'
          description: Detail of the entry, e.g. `Yellow Card`, `Normal Goal`, or the player coming on.
          examples:
          - Yellow Card
    TvListing:
      type: object
      description: TvListing record. Every value is a string or null; `""` also means no value.
      properties:
        dateEvent:
          type:
          - string
          - 'null'
          description: Date of the event, `YYYY-MM-DD`, in **UTC**.
          examples:
          - '2026-10-10'
        id:
          type:
          - string
          - 'null'
          description: Id of this TV listing.
          examples:
          - '1218715'
        idChannel:
          type:
          - string
          - 'null'
          description: TV channel id. Use it with `eventstv.php?id=` (v1) or `filter/tv/channelid/{id}` (v2).
          examples:
          - '582'
        idEvent:
          type:
          - string
          - 'null'
          description: Event id.
          examples:
          - '2494052'
        intDivision:
          type:
          - string
          - 'null'
          description: Division level; `1` is a top flight. Cups often use `0` or `99`.
          examples:
          - '0'
        strChannel:
          type:
          - string
          - 'null'
          description: TV channel name, e.g. `TSN 1`.
          examples:
          - Disney+ Hotstar
        strCountry:
          type:
          - string
          - 'null'
          description: Country of the TV channel.
          examples:
          - India
        strEvent:
          type:
          - string
          - 'null'
          description: Event name, usually `Home vs Away`.
          examples:
          - Arsenal vs Leeds United
        strEventBanner:
          type:
          - string
          - 'null'
          description: Banner for the event.
          examples:
          - https://r2.thesportsdb.com/images/media/event/banner/h61dc61784549908.jpg
        strEventCountry:
          type:
          - string
          - 'null'
          description: Country where the event takes place.
          examples:
          - England
        strEventPoster:
          type:
          - string
          - 'null'
          description: Poster for the event.
          examples:
          - https://r2.thesportsdb.com/images/media/event/poster/ekc9q71784549630.jpg
        strEventSquare:
          type:
          - string
          - 'null'
          description: Square image for the event.
          examples:
          - https://r2.thesportsdb.com/images/media/event/square/kzqbsy1784550175.jpg
        strEventThumb:
          type:
          - string
          - 'null'
          description: Thumbnail for the event.
          examples:
          - https://r2.thesportsdb.com/images/media/event/thumb/mayo9h1784549326.jpg
        strLogo:
          type:
          - string
          - 'null'
          description: The channel's logo.
          examples:
          - https://r2.thesportsdb.com/images/media/channel/logo/7za33k1683192230.png
        strSeason:
          type:
          - string
          - 'null'
          description: Season name, e.g. `2026-2027`, or `2026` for single-year leagues.
          examples:
          - 2026-2027
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strTime:
          type:
          - string
          - 'null'
          description: Start time, `HH:MM:SS`, in **UTC**.
          examples:
          - '11:30:00'
        strTimeStamp:
          type:
          - string
          - 'null'
          description: Broadcast start, `YYYY-MM-DD HH:MM:SS` (note the space and the capital S), in **UTC**.
          examples:
          - '2026-10-10 11:30:00'
    Venue:
      type: object
      description: Venue record. Every value is a string or null; `""` also means no value.
      properties:
        idDupe:
          type:
          - string
          - 'null'
          description: Set when this venue duplicates another record; the id of the original.
        idVenue:
          type:
          - string
          - 'null'
          description: Venue id.
          examples:
          - '23604'
        intCapacity:
          type:
          - string
          - 'null'
          description: Venue capacity.
          examples:
          - '90000'
        intFormedYear:
          type:
          - string
          - 'null'
          description: Year founded. `0` means unknown.
          examples:
          - '0'
        intLoved:
          type:
          - string
          - 'null'
          description: Number of users who marked this as a favourite.
        strArchitect:
          type:
          - string
          - 'null'
          description: The venue's architect.
        strCost:
          type:
          - string
          - 'null'
          description: Construction cost, as text.
          examples:
          - £789 million
        strCountry:
          type:
          - string
          - 'null'
          description: Country.
          examples:
          - Jamaica
        strCreativeCommons:
          type:
          - string
          - 'null'
          description: Whether the artwork is Creative Commons (`Yes`/`No`/`NO`). Artwork that isn't may not be used in published
            apps.
          examples:
          - 'NO'
        strDescriptionEN:
          type:
          - string
          - 'null'
          description: Description in language `EN`.
          examples:
          - Wembley Stadium (currently known officially as Wembley Stadium connected by EE for commercial sponsorship reasons)
            is an association football stadium in Wemb…
        strFacebook:
          type:
          - string
          - 'null'
          description: Facebook page, often without a scheme.
          examples:
          - www.facebook.com/WembleyStadium
        strFanart1:
          type:
          - string
          - 'null'
          description: Fan art image 1.
          examples:
          - https://r2.thesportsdb.com/images/media/venue/fanart/7tpavy1708696222.jpg
        strFanart2:
          type:
          - string
          - 'null'
          description: Fan art image 2.
          examples:
          - https://r2.thesportsdb.com/images/media/venue/fanart/3zirzg1708696411.jpg
        strFanart3:
          type:
          - string
          - 'null'
          description: Fan art image 3.
          examples:
          - https://r2.thesportsdb.com/images/media/venue/fanart/c482m41708696417.jpg
        strFanart4:
          type:
          - string
          - 'null'
          description: Fan art image 4.
          examples:
          - https://r2.thesportsdb.com/images/media/venue/fanart/ncll4t1708696444.jpg
        strInstagram:
          type:
          - string
          - 'null'
          description: Instagram profile, often without a scheme.
          examples:
          - www.instagram.com/wembleystadium
        strLocation:
          type:
          - string
          - 'null'
          description: Location, e.g. `Holloway, London, England`.
          examples:
          - Hayes, Clarendon, Jamaica
        strLocked:
          type:
          - string
          - 'null'
          description: '`locked` or `unlocked`: whether the record is protected from edits.'
          examples:
          - unlocked
        strLogo:
          type:
          - string
          - 'null'
          description: Logo image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/venue/logo/zowstr1709984100.png
        strMap:
          type:
          - string
          - 'null'
          description: Either coordinates as `latitude, longitude`, or a map image URL.
          examples:
          - 51.555556, -0.279444
        strSport:
          type:
          - string
          - 'null'
          description: Sport name, e.g. `Soccer`, `Ice Hockey`. Use this spelling for sport filters.
          examples:
          - Soccer
        strThumb:
          type:
          - string
          - 'null'
          description: Thumbnail image URL.
          examples:
          - https://r2.thesportsdb.com/images/media/venue/thumb/qttuty1420627847.jpg
        strTimezone:
          type:
          - string
          - 'null'
          description: The venue's time zone as text, e.g. `UTC +00:00 Greenwich Mean Time (GMT)`.
          examples:
          - UTC -05:00 Eastern Standard Time (EST)
        strTwitter:
          type:
          - string
          - 'null'
          description: Twitter/X profile, often without a scheme.
          examples:
          - twitter.com/wembleystadium
        strVenue:
          type:
          - string
          - 'null'
          description: Venue name.
          examples:
          - Wembley Centre of Excellence
        strVenueAlternate:
          type:
          - string
          - 'null'
          description: Alternate venue name.
          examples:
          - Wembley
        strVenueSponsor:
          type:
          - string
          - 'null'
          description: Sponsored name of the venue.
        strWebsite:
          type:
          - string
          - 'null'
          description: Website, often without a scheme (`www.arsenal.com`).
          examples:
          - www.wembleystadium.com
        strYoutube:
          type:
          - string
          - 'null'
          description: YouTube channel, often without a scheme.
    Message:
      type: object
      properties:
        Message:
          type: string
          description: 'A message instead of data, e.g. `No data found` or `Invalid Premium API key: ...`.'
      example:
        Message: 'Invalid Premium API key: Signup here: https://www.thesportsdb.com/pricing'
  responses:
    InvalidKey:
      description: The key isn't accepted (only `123`, `3` and paid keys work).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Message'
    RateLimited:
      description: Over the rate limit (30 a minute free, 100 premium, 120 business). Wait a minute.
  parameters:
    apiKey:
      name: apiKey
      in: path
      required: true
      schema:
        type: string
      example: '123'
      description: Your API key. `123` is the free key for development and testing (`3` also works, with the same limits).
        The key is in the URL, so treat v1 URLs as secrets and don't log them.
