openapi: 3.1.0
info:
  title: SoccersAPI
  description: |-
    REST API for football (soccer) data: search, livescores, fixtures, leagues,
    teams, seasons, players, coaches, referees, venues, statistics, head-to-head,
    bookmakers, markets, broadcasts and media.

    Authentication is required on every request via the `user` and `token`
    query parameters.

    <!-- BEGIN GENERATED CHANGELOG: docs/04-changelog.md -->
    # [v2.2] Release notes

    > Use the examples in the notes to test endpoints directly.
    > Use the `include` parameter to embed related datasets in one call (for example `include=events,stats`) and reduce round trips. Dataset include names are different from standalone operation selectors such as `t=match_events`.
    > Use the `utc` parameter to get date/time values in your preferred timezone (for example `utc=4` or `utc=4.5`).

    ## Documentation verification (2026-09-04)

    - Every operation of every route was exercised against production and the
      reference now lists all accepted `t` values per route with their parameters,
      response schemas and a captured example each.
    - Documented operations that were missing from the reference: `leaders`
      `topcards`, `bookmakers` and `markets` `list`, `referees` `list`, `venues`
      `info`, `rounds` `info`; `players`, `coaches`, `venues` and `referees` lists
      work without `country_id`.
    - Pagination: 100 items per page on entity lists, livescores feeds,
      `fixtures?t=schedule` and `broadcast?t=schedule`; `per_page` is not
      supported. Season fixtures, leaders, match datasets and search return in
      full.
    - `has_schedule` and `country_broadcast_id` have no effect and were removed.
      `t=multiple` is not valid; use `t=sort&ids=`.
    - Media highlights are announced but not live yet; the route is marked
      "coming soon".

    ## Documentation correction (2026-08-30)

    - Corrected match dataset include names to `events` and `stats`.
    - Clarified that `t=match_events` is the standalone event operation, not an
      include value.
    - Corrected match-by-ID and batch selectors to `t=info&id=...` and
      `t=sort&ids=...`.
    - Added the match-event response schema, scorer/assist nullability and live
      publication guidance.

    ## 🏟️ Venues by Season
    - **Venues by Season** — added `t=byseason` to the **Venues** endpoint to return the venues linked to a specific season.
    - **Season venue data** — use `season_id` to fetch the basic venue information from the season venue list.

    **Example**
    ```txt
    GET /v2.2/venues/?user=USER&token=TOKEN&t=byseason&season_id=14192
    ```

    ## ⚡ Performance & Team Kit Colors
    - **Performance improvements** — optimized API response times and improved overall request handling for a faster experience.
    - **Team kit colors** — added `kit` colors to the **Teams by ID** endpoint for richer team visual data.
    - **Minor updates** — applied small fixes, refinements, and stability improvements across the API.

    ## 🛡️ API Token Usage
    - **API Token usage tracking** — monitor token consumption, see usage by endpoint, and review historical trends.
    - **Token dashboard** — quick overview of all tokens and their activity.
    - **Usage insights** — identify high-traffic endpoints and optimize token allocation.

    ---

    ## 🚀 Highlights (quick glance)
    - **Media / highlights** endpoints (beta) — fetch highlights by league, team, event, date.
    - **Standings Live** endpoint — live/rolling standings while matches are in progress.
    - **Broadcast / TV** improvements — TV-by-country, TV-by-match, fixtures-by-TV-channel.
    - **Odds enhancements** — new bookmaker (Betika), per-bookmaker match odds endpoint and custom sort.
    - **Includes** support: include `events` and `stats` inline in match-returning endpoints.
    - **Language additions** and **default images** for missing entities.
    - **Historical data** extended (up to 10 years).

    ---

    ## 📺 Broadcast & TV (new & improved)
    **What’s included**
    - `TV Channels by Country` (`#tv_channels_country`)
    - `All TV Channels` (`#tv_channels_all`)
    - `TV Channel by ID` (`#tv_info`)
    - Improved `TV Channels by Match` coverage (`#match_tv`)
    - `Fixtures by TV Channel` (2-week forecast) (`#fixtures_tv_channel`)
    - `TV Schedule by Date` (Broadcast section)

    **Commentary**
    Use these endpoints for “Where to watch” features. You can filter broadcasts per country to show local channels only.

    **Example**
    ```txt
    GET /v2.2/broadcast/?user=USER&token=TOKEN&t=match_tvs&id=1910954&country_broadcast_id=5
    ```

    > Verification note (2026-09-04): `country_broadcast_id` currently has no
    > effect; `t=match_tvs` returns the channels of every country.

    ---

    ## 🎞️ Media (beta)
    **What’s included**
    - Media / highlights endpoint in beta. Query by: `event`, `league`, `season`, `team`, `round`, `date` (use `type=date&d=YYYY-MM-DD`).

    **Example**
    ```txt
    GET /v2.2/media/?user=USER&token=TOKEN&t=league&id=637
    ```

    **Commentary**
    Good for editorial UIs, highlight carousels and social previews. Beta feature — expect small improvements.

    > Verification note (2026-09-04): the media route is not live yet and is
    > marked "coming soon" in the reference.

    ---

    ## 📊 Standings & Live Standings
    **What’s included**
    - New endpoint: **Standings Live** (`#standings_live`) — rolling/temporary standings while matches are being played.
    - `number_standings` added to support competitions with multiple tables (e.g., split groups).

    **Commentary**
    Use for live leaderboard views and competition pages that need in-play table updates.

    ---

    ## ⚽ Matches, Fixtures & Includes
    **New & improved**
    - `related_id` parameter in fixtures: track postponed / rescheduled / related events.
    - `info` dataset added to today’s fixtures (federation decisions, special notes).
    - **Includes** support across match-returning operations — request `&include=events,stats` inline in:
      - `Livescores`, fixture schedules, `t=info` (match by ID) and `t=sort` (multiple match IDs)
    - `timestamp` added to today’s match events for more precise timing.
    - `aggregate_id` and `country_code` added in fixtures and MatchByID endpoints.

    **Usage tip**
    ```txt
    GET /v2.2/fixtures/?user=USER&token=TOKEN&t=info&id=XXXX&include=events,stats
    ```

    **Commentary**
    `&include=` reduces roundtrips and gives richer payloads in a single call.

    ---

    ## 🧾 Players / Teams / Lineups
    **Added**
    - `team_id` and `national_team_id` on player object.
    - `position_name` in lineups (e.g., left winger, right winger).
    - `market_value` in player info.
    - Player seasons & roles in Player by ID.
    - Team seasons and extended `leagues` array in Team by ID.
    - Basic player stats included in Match Lineups endpoint (default: formation without per-player stats; add `&include=stats` for full stats).
      *Verification note (2026-09-04): `include=stats` returned no per-player statistics on the matches tested.*

    **Commentary**
    Easier to render detailed player/team pages without additional joins. For performance, lineups omit heavy per-player stats by default.

    ---

    ## 🏟️ Venues / Coaches / Catalog
    **New endpoints**
    - `Coaches by Country`, `All Coaches`
    - `Venues by Country`, `All Venues`
    - `All Continents`, `Continent by ID`

    **Images & logos**
    - Logos added for 800+ leagues.
    - Venue images now in PNG and available in sizes: **100**, **80**, **50**, **18** px.

    **Commentary**
    Useful for directory pages and localized UI elements.

    ---

    ## 🔎 Search & H2H
    **Added**
    - `search_all` improvements: you can now search **matches** and **TV channels**.
    - H2H endpoints: `H2H Team vs Team` and `Match H2H`.

    **Commentary**
    Power autocompletes and quick lookup features with the search endpoints.

    ---

    ## 🧩 Odds & Bookmakers
    **Added / Improved**
    - New bookmaker: **Betika** (`#match_odds`).
    - Bookmakers custom sort (control ordering returned).
    - New endpoint: `Match Odds by Bookmaker`.
    - Markets: 1X2 (primary), Asian Handicap (AH), Over/Under (Goal Line).

    **Commentary**
    Odds coverage varies by match/popularity. Use `match_odds` endpoints and custom sort to prioritize affiliate/bookmaker display order.

    ---

    ## 🌐 Languages & Localization
    **Added languages**
    - Korean (`ko`)
    - Chinese simplified (`zh_cn`) and Chinese (`zh`)
    - Portuguese (`pt`)
    - Turkish (`tr`)
    - Polish (`pl`)
    - French (`fr`)
    **Beta:** Arabic, Greek, Italian

    **Usage**
    ```txt
    ...&lang=ko
    ```

    **Commentary**
    Pass `&lang=` to localize names and descriptions in responses.

    ---

    ## 🖼️ UX / Images / Defaults
    **Added**
    - Default images for missing leagues, teams and players (prevent broken UIs).
    - Team kit colors on fixtures endpoints.
    - TV channel images in four sizes (100, 80, 50, 18).

    **Commentary**
    Better visual fallback handling and consistent front-end rendering.

    ---

    ## 🔧 Improvements / Changes / Fixes
    **Performance / API behavior**
    - Match lineups now return formation without per-player stats by default to avoid latency. Add `&include=stats` when you need full player stats.
    - `Fixtures` endpoints datetime values normalized to **UTC**.
    - `Standings` improvements: `number_standings` for competitions with multiple standing groups (e.g., Indian I-League).
    - `Fixtures` got `info` dataset — federation decisions and special flags included.

    **Other fixes**
    - `Season Stats > goal_line` recalculated/fixed.
    - Historical data extended to **10 years**.
    - `timestamp` parameter added in match events for today (higher precision).
    - `Attendance` field added.
    - `Aggregate_id` in fixtures and MatchByID endpoints.

    ---

    ## ➕ New Endpoints (summary)
    - `Standings Live` (`#standings_live`)
    - `Media` (highlights) (beta)
    - `TV Channels by Country`, `All TV Channels`, `TV Channel by ID`
    - `Fixtures Next & Last`
    - `Match Sidelined`
    - `Match by Multiple IDs` (includes support)
    - `Player Stats by Match ID` (`#player_stats_match`)
    - `Cup Draw (Tournament Bracket)` (`#cup_draw`)
    - `Fixtures by TV Channel` (2 weeks forecast)
    - `Match Odds by Bookmaker`
    - `Teams National`
    - `Team Transfers`
    - `Team Trophies`
    - `Search by Keyword`
    - `Stages by Season`, `Stage by ID`, `Group by ID`
    - `Venues by Country`, `All Venues`
    - `Coaches by Country`, `All Coaches`

    ---

    ## 🧾 Coverage & Data
    - **Historical data**: up to **10 years** available where applicable.
    - **Logos**: +800 leagues now have logos.
    - **Fixtures**: `country_code` & `aggregate_id` for improved grouping and filtering.

    ---

    ## ✅ Migration tips & examples
    - If you use **match lineups** and previously relied on per-player stats, add `&include=stats` to your request now:
    ```txt
    GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_lineups&id=1234&include=stats
    ```
    - To fetch **live standings**:
    ```txt
    GET /v2.2/leagues/?user=USER&token=TOKEN&t=standings_live&season_id=SEASON_ID
    ```
    - To request **media highlights** (beta):
    ```txt
    GET /v2.2/media/?user=USER&token=TOKEN&t=league&id=637
    ```
    - To get richer match payloads in one call:
    ```txt
    GET /v2.2/fixtures/?user=USER&token=TOKEN&t=info&id=XXXX&include=events,stats
    ```

    ---

    ## 📣 Final notes & recommendations
    - Use `&utc=` for timezone-correct responses where useful (e.g., `&utc=4` or `&utc=4.5`).
    - Use `&include=events,stats` to avoid separate match-event and match-stat round trips. Use `include=stats` on `t=match_lineups` when full per-player lineup statistics are required.
    - For heavy live polling (odds/last-minute updates), ensure your plan supports the required requests/hour.
    - Media endpoints are **beta** — expect iterative improvements.

    ---

    <!-- END GENERATED CHANGELOG -->
  version: 2.2.0
  contact:
    name: SoccersAPI
    url: https://soccersapi.com
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
  - url: https://api.soccersapi.com
    description: Production
tags:
  - name: Search
    description: Find matches and football entities by keyword.
  - name: Geography
    description: Continents and countries used by the football data model.
  - name: Competitions
    description: Leagues, seasons, stages, groups and rounds.
  - name: Teams
    description: Team profiles, lists, squads, transfers and related datasets.
  - name: Livescores
    description: Live and day-based match feeds.
  - name: Fixtures
    description: Fixture lists, match details and match-related datasets.
  - name: Statistics
    description: Match, league, season, team and player statistics.
  - name: Head to head
    description: Historical matchups between matches or teams.
  - name: Leaders
    description: Competition leaderboards such as scorers, assists and cards.
  - name: Betting
    description: Bookmakers, markets and match odds metadata.
  - name: Broadcast
    description: Television schedules and match broadcast availability.
  - name: People
    description: Players, coaches and referees.
  - name: Venues
    description: Stadium and venue information.
  - name: Media
    description: Match media and highlight resources.
paths:
  /v2.2/search/:
    get:
      summary: Search
      operationId: search
      tags:
        - Search
      description: |
        Find matches and football entities by keyword. Results are lightweight: they carry the ID and the display name needed to call the resource endpoints, plus a `type` discriminator.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored. The theme column marks datasets that themed plans (Odds, Broadcast) include only for their own theme; Free and Standard plans include every theme for their leagues.

        | `t` | Operation | Required | Optional | Theme |
        | --- | --- | --- | --- | --- |
        | `match` | Search matches. Upcoming and recent matches whose teams or competition match `q`, with kickoff date, teams and league. | `q` | `utc` | core |
        | `league` | Search leagues. Leagues matching `q`, with country. | `q` | — | core |
        | `team` | Search teams. Teams whose name matches `q`. | `q` | — | core |
        | `player` | Search players. Players whose name matches `q`. | `q` | — | core |
        | `referee` | Search referees. Referees whose name matches `q`. | `q` | — | core |
        | `country` | Search countries. Countries whose name matches `q`, with country code. | `q` | — | core |
        | `continent` | Search continents. Continents whose name matches `q`. | `q` | — | core |
        | `tv` | Search TV channels. TV channels matching `q`, for use with broadcast operations. | `q` | — | broadcast |

        `t=channel` is accepted as an alias of `t=tv`. Search responses are not paginated and report `meta.count` and `meta.total` as `0`; use the length of `data`.

        ## Examples

        Search matches:

        ```http
        GET /v2.2/search/?user=USER&token=TOKEN&t=match&q=salzburg
        ```

        Search leagues:

        ```http
        GET /v2.2/search/?user=USER&token=TOKEN&t=league&q=bundesliga
        ```

        Search teams:

        ```http
        GET /v2.2/search/?user=USER&token=TOKEN&t=team&q=barcelona
        ```

        Search players:

        ```http
        GET /v2.2/search/?user=USER&token=TOKEN&t=player&q=ronaldo
        ```

        Search referees:

        ```http
        GET /v2.2/search/?user=USER&token=TOKEN&t=referee&q=clattenburg
        ```

        Search countries:

        ```http
        GET /v2.2/search/?user=USER&token=TOKEN&t=country&q=austria
        ```

        Search continents:

        ```http
        GET /v2.2/search/?user=USER&token=TOKEN&t=continent&q=europe
        ```

        Search TV channels:

        ```http
        GET /v2.2/search/?user=USER&token=TOKEN&t=tv&q=dazn
        ```
      x-operations:
        - t: match
          title: Search matches
          purpose: Upcoming and recent matches whose teams or competition match `q`, with kickoff date, teams and league.
          required:
            - q
          optional:
            - utc
          schema: SearchResponse
          example: q=salzburg
        - t: league
          title: Search leagues
          purpose: Leagues matching `q`, with country.
          required:
            - q
          optional: []
          schema: SearchResponse
          example: q=bundesliga
        - t: team
          title: Search teams
          purpose: Teams whose name matches `q`.
          required:
            - q
          optional: []
          schema: SearchResponse
          example: q=barcelona
        - t: player
          title: Search players
          purpose: Players whose name matches `q`.
          required:
            - q
          optional: []
          schema: SearchResponse
          example: q=ronaldo
        - t: referee
          title: Search referees
          purpose: Referees whose name matches `q`.
          required:
            - q
          optional: []
          schema: SearchResponse
          example: q=clattenburg
        - t: country
          title: Search countries
          purpose: Countries whose name matches `q`, with country code.
          required:
            - q
          optional: []
          schema: SearchResponse
          example: q=austria
        - t: continent
          title: Search continents
          purpose: Continents whose name matches `q`.
          required:
            - q
          optional: []
          schema: SearchResponse
          example: q=europe
        - t: tv
          title: Search TV channels
          purpose: TV channels matching `q`, for use with broadcast operations.
          required:
            - q
          optional: []
          schema: SearchResponse
          theme: broadcast
          example: q=dazn
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: match
          schema:
            type: string
            enum:
              - match
              - league
              - team
              - player
              - referee
              - country
              - continent
              - tv
            x-enumDescriptions:
              match: Search matches
              league: Search leagues
              team: Search teams
              player: Search players
              referee: Search referees
              country: Search countries
              continent: Search continents
              tv: Search TV channels
        - name: q
          in: query
          required: true
          description: 'Search text: part of a team, league, player, referee, country, continent or TV channel name. At least 3 characters; shorter terms return `400`. Required by every operation.'
          schema:
            type: string
          example: salzburg
        - $ref: '#/components/parameters/Utc'
      responses:
        '200':
          description: Array of search results. Match results carry `startdate`, `home`, `away`, `league_name`, `country_name` and `cc`; entity results carry `id`, `name` and `type`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResponse'
              examples:
                match:
                  summary: Search matches
                  value:
                    data:
                      - id: 2612624
                        startdate: '2026-09-04 17:00:00'
                        name: Sak salzburg vs Atsv salzburg
                        home: Sak salzburg
                        away: Atsv salzburg
                        league_name: Regionalliga Salzburg
                        country_name: Austria
                        cc: at
                        type: match
                      - id: 2598573
                        startdate: '2026-09-05 14:30:00'
                        name: Austria salzburg vs First vienna
                        home: Austria salzburg
                        away: First vienna
                        league_name: OFB Cup
                        country_name: Austria
                        cc: at
                        type: match
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: 0
                      msg: ''
                league:
                  summary: Search leagues
                  value:
                    data:
                      - id: 1855
                        name: 2. Bundesliga, Women
                        country_name: Germany
                        cc: de
                        type: league
                      - id: 592
                        name: 2nd Bundesliga
                        country_name: Germany
                        cc: de
                        type: league
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: 0
                      msg: ''
                team:
                  summary: Search teams
                  value:
                    data:
                      - id: 99
                        name: Barcelona
                        type: team
                      - id: 3233
                        name: Barcelona
                        type: team
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: 0
                      msg: ''
                player:
                  summary: Search players
                  value:
                    data:
                      - id: 155067
                        name: Abarca, Ronaldo
                        type: player
                      - id: 208615449
                        name: Afonso, Ronaldo
                        type: player
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: 0
                      msg: ''
                referee:
                  summary: Search referees
                  value:
                    data:
                      - id: 1313
                        name: Clattenburg, Mark
                        type: referee
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: 0
                      msg: ''
                country:
                  summary: Search countries
                  value:
                    data:
                      - id: 15
                        name: Austria
                        cc: at
                        type: country
                      - id: 16
                        name: Austria Amateur
                        cc: null
                        type: country
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: 0
                      msg: ''
                continent:
                  summary: Search continents
                  value:
                    data:
                      - id: 2
                        name: Europe
                        type: continent
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: 0
                      msg: ''
                tv:
                  summary: Search TV channels
                  value:
                    data:
                      - id: 8454
                        name: 214 DAZN Zona
                        type: channel / broadcast
                      - id: 9361
                        name: 215 DAZN Zona
                        type: channel / broadcast
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: 0
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/continents/:
    get:
      summary: Continents
      operationId: getContinents
      tags:
        - Geography
      description: |
        Continents of the football data model. Catalogue data, not filtered by the leagues enabled on the account.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `list` | All continents. The seven continents of the data model. | — | — |
        | `info` | Continent by ID. One continent. | `id` | — |

        ## Examples

        All continents:

        ```http
        GET /v2.2/continents/?user=USER&token=TOKEN&t=list
        ```

        Continent by ID:

        ```http
        GET /v2.2/continents/?user=USER&token=TOKEN&t=info&id=2
        ```
      x-operations:
        - t: list
          title: All continents
          purpose: The seven continents of the data model.
          required: []
          optional: []
          schema: DataResponse
          example: ''
        - t: info
          title: Continent by ID
          purpose: One continent.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=2
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: list
          schema:
            type: string
            enum:
              - list
              - info
            x-enumDescriptions:
              list: All continents
              info: Continent by ID
        - name: id
          in: query
          required: false
          description: Continent ID. Required when `t` is `info`.
          schema:
            type: string
          example: '2'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                list:
                  summary: All continents
                  value:
                    data:
                      - id: 4
                        name: North America
                      - id: 2
                        name: Europe
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 7
                      total: 7
                      msg: ''
                info:
                  summary: Continent by ID
                  value:
                    data:
                      id: 2
                      name: Europe
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/countries/:
    get:
      summary: Countries
      operationId: getCountries
      tags:
        - Geography
      description: |
        Countries of the football data model, with continent, ISO code and flag image. Catalogue data, not filtered by the leagues enabled on the account.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `list` | All countries. Every country. Paginated, 100 items per page. | — | `page` |
        | `info` | Country by ID. One country with continent, ISO code and flag image. | `id` | — |

        ## Examples

        All countries:

        ```http
        GET /v2.2/countries/?user=USER&token=TOKEN&t=list&page=1
        ```

        Country by ID:

        ```http
        GET /v2.2/countries/?user=USER&token=TOKEN&t=info&id=4
        ```
      x-operations:
        - t: list
          title: All countries
          purpose: Every country. Paginated, 100 items per page.
          required: []
          optional:
            - page
          schema: DataResponse
          paginated: true
          example: page=1
        - t: info
          title: Country by ID
          purpose: One country with continent, ISO code and flag image.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=4
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: list
          schema:
            type: string
            enum:
              - list
              - info
            x-enumDescriptions:
              list: All countries
              info: Country by ID
        - name: id
          in: query
          required: false
          description: Country ID. Required when `t` is `info`.
          schema:
            type: string
          example: '4'
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                list:
                  summary: All countries
                  value:
                    data:
                      - id: 136
                        name: Africa
                        continent: Africa
                        sub_region: null
                        code: null
                      - id: 9
                        name: Algeria
                        continent: Africa
                        sub_region: null
                        code: dz
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 2
                      count: 100
                      total: 139
                      msg: ''
                info:
                  summary: Country by ID
                  value:
                    data:
                      id: 4
                      name: Germany
                      continent: Europe
                      sub_region: null
                      long: null
                      lat: null
                      img: https://cdn.soccersapi.com/images/countries/30/de.png
                      code: de
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/leagues/:
    get:
      summary: Leagues and standings
      operationId: getLeagues
      tags:
        - Competitions
      description: |
        League profiles, league lists, standings and cup brackets. A league profile carries its `seasons` array and the IDs of the current season, stage and round, which are the entry points for fixtures, standings and leaders.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `list` | All leagues. Leagues available to the account, optionally filtered by country. Paginated, 100 items per page. | — | `country_id`, `page` |
        | `info` | League by ID. League profile with seasons and current season, stage and round. | `id` | — |
        | `sort` | Leagues by multiple IDs. Several league profiles in one request. | `ids` | — |
        | `standings` | Standings. League table for a season. Competitions with several tables (groups, splits) return one entry per table, identified by `number_standings`. | `season_id` | — |
        | `standings_live` | Live standings. Rolling table that includes the matches currently in play. | `season_id` | — |
        | `cup_draw` | Cup draw (tournament bracket). Knockout bracket of a cup stage. | `season_id`, `stage_id` | — |

        The public reference shows `t=multiple&id=…` on one page for the batch lookup; `t=sort&ids=…` is the form shared with teams and fixtures.

        ## Examples

        All leagues:

        ```http
        GET /v2.2/leagues/?user=USER&token=TOKEN&t=list&country_id=4
        ```

        League by ID:

        ```http
        GET /v2.2/leagues/?user=USER&token=TOKEN&t=info&id=1005
        ```

        Leagues by multiple IDs:

        ```http
        GET /v2.2/leagues/?user=USER&token=TOKEN&t=sort&ids=974,1005,1609
        ```

        Standings:

        ```http
        GET /v2.2/leagues/?user=USER&token=TOKEN&t=standings&season_id=406
        ```

        Live standings:

        ```http
        GET /v2.2/leagues/?user=USER&token=TOKEN&t=standings_live&season_id=406
        ```

        Cup draw (tournament bracket):

        ```http
        GET /v2.2/leagues/?user=USER&token=TOKEN&t=cup_draw&season_id=45&stage_id=26
        ```
      x-operations:
        - t: list
          title: All leagues
          purpose: Leagues available to the account, optionally filtered by country. Paginated, 100 items per page.
          required: []
          optional:
            - country_id
            - page
          schema: DataResponse
          paginated: true
          example: country_id=4
        - t: info
          title: League by ID
          purpose: League profile with seasons and current season, stage and round.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=1005
        - t: sort
          title: Leagues by multiple IDs
          purpose: Several league profiles in one request.
          required:
            - ids
          optional: []
          schema: DataResponse
          example: ids=974,1005,1609
        - t: standings
          title: Standings
          purpose: League table for a season. Competitions with several tables (groups, splits) return one entry per table, identified by `number_standings`.
          required:
            - season_id
          optional: []
          schema: StandingsResponse
          example: season_id=406
        - t: standings_live
          title: Live standings
          purpose: Rolling table that includes the matches currently in play.
          required:
            - season_id
          optional: []
          schema: StandingsResponse
          example: season_id=406
        - t: cup_draw
          title: Cup draw (tournament bracket)
          purpose: Knockout bracket of a cup stage.
          required:
            - season_id
            - stage_id
          optional: []
          schema: DataResponse
          example: season_id=45&stage_id=26
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: list
          schema:
            type: string
            enum:
              - list
              - info
              - sort
              - standings
              - standings_live
              - cup_draw
            x-enumDescriptions:
              list: All leagues
              info: League by ID
              sort: Leagues by multiple IDs
              standings: Standings
              standings_live: Live standings
              cup_draw: Cup draw (tournament bracket)
        - name: id
          in: query
          required: false
          description: League ID. Required when `t` is `info`.
          schema:
            type: string
          example: '1005'
        - name: ids
          in: query
          required: false
          description: Comma-separated league IDs, without spaces. Required when `t` is `sort`.
          schema:
            type: string
          example: 974,1005,1609
        - name: country_id
          in: query
          required: false
          description: Country ID. Optional for `list`.
          schema:
            type: string
          example: '4'
        - name: season_id
          in: query
          required: false
          description: Season ID. Required when `t` is `standings`, `standings_live`, `cup_draw`.
          schema:
            type: string
          example: '406'
        - name: stage_id
          in: query
          required: false
          description: Stage ID. Required when `t` is `cup_draw`.
          schema:
            type: string
          example: '26'
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: |-
            The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.

            - `t=list`: DataResponse
            - `t=info`: DataResponse
            - `t=sort`: DataResponse
            - `t=standings`: StandingsResponse
            - `t=standings_live`: StandingsResponse
            - `t=cup_draw`: DataResponse
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/DataResponse'
                  - $ref: '#/components/schemas/StandingsResponse'
              examples:
                list:
                  summary: All leagues
                  value:
                    data:
                      - id: '6225'
                        name: Oberliga NOFV
                        is_cup: '0'
                        is_amateur: '1'
                        is_friendly: '0'
                        img: https://cdn.soccersapi.com/images/soccer/leagues/100/6225.png
                        id_current_season: '15860'
                        id_current_stage: null
                        id_current_round: null
                        continent:
                          id: '2'
                          name: Europe
                        country:
                          id: '4'
                          name: Germany
                          cc: de
                        seasons: []
                      - id: '594'
                        name: Bundesliga
                        is_cup: '0'
                        is_amateur: '0'
                        is_friendly: '0'
                        img: https://cdn.soccersapi.com/images/soccer/leagues/100/594.png
                        id_current_season: '21268'
                        id_current_stage: '1'
                        id_current_round: '220932'
                        continent:
                          id: '2'
                          name: Europe
                        country:
                          id: '4'
                          name: Germany
                          cc: de
                        seasons: []
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 40
                      total: 40
                      msg: ''
                info:
                  summary: League by ID
                  value:
                    data:
                      id: 1005
                      name: Tipico Bundesliga
                      is_cup: '0'
                      is_amateur: '0'
                      is_friendly: '0'
                      img: https://cdn.soccersapi.com/images/soccer/leagues/100/1005.png
                      id_current_season: '21096'
                      id_current_stage: '1'
                      id_current_round: '217291'
                      continent:
                        id: 2
                        name: Europe
                      country:
                        id: 15
                        name: Austria
                        cc: at
                      seasons:
                        - id: 21096
                          name: 26/27
                          is_current: '1'
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                sort:
                  summary: Leagues by multiple IDs
                  value:
                    data:
                      - id: '974'
                        name: A-League
                        is_cup: '0'
                        is_amateur: '0'
                        is_friendly: '0'
                        img: https://cdn.soccersapi.com/images/soccer/leagues/100/974.png
                        id_current_season: '21306'
                        id_current_stage: '1'
                        id_current_round: '221498'
                        continent:
                          id: '7'
                          name: Oceania
                        country:
                          id: '14'
                          name: Australia
                          cc: au
                        seasons:
                          - id: 21306
                            name: 26/27
                            is_current: '1'
                      - id: '1005'
                        name: Tipico Bundesliga
                        is_cup: '0'
                        is_amateur: '0'
                        is_friendly: '0'
                        img: https://cdn.soccersapi.com/images/soccer/leagues/100/1005.png
                        id_current_season: '21096'
                        id_current_stage: '1'
                        id_current_round: '217291'
                        continent:
                          id: '2'
                          name: Europe
                        country:
                          id: '15'
                          name: Austria
                          cc: at
                        seasons:
                          - id: 21096
                            name: 26/27
                            is_current: '1'
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 3
                      total: 3
                      msg: ''
                standings:
                  summary: Standings
                  value:
                    data:
                      league_id: 594
                      season_id: 406
                      has_groups: 0
                      number_standings: 1
                      standings:
                        - team_id: 111
                          team_name: FC Bayern Munich
                          group: Bundesliga
                          group_name: ''
                          overall:
                            games_played: 34
                            won: 26
                            draw: 4
                            lost: 4
                            goals_diff: 68
                            goals_scored: 100
                            goals_against: 32
                            points: 82
                            position: 1
                          home:
                            games_played: 17
                            won: 13
                            draw: 2
                            lost: 2
                            goals_diff: 38
                            goals_scored: 53
                            goals_against: 15
                            points: 41
                            position: 1
                          away:
                            games_played: 17
                            won: 13
                            draw: 2
                            lost: 2
                            goals_diff: 30
                            goals_scored: 47
                            goals_against: 17
                            points: 41
                            position: 1
                          total: 34
                          status: Promotion
                          result: Champions League
                          points: 82
                          recent_form: WWWWW
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                standings_live:
                  summary: Live standings
                  value:
                    data:
                      league_id: 594
                      season_id: '406'
                      has_groups: 0
                      number_standings: 1
                      standings:
                        - team_id: '111'
                          team_name: FC Bayern Munich
                          group: Bundesliga
                          group_name: ''
                          overall:
                            games_played: 34
                            won: 26
                            draw: 4
                            lost: 4
                            goals_diff: 68
                            goals_scored: 100
                            goals_against: 32
                            points: 82
                            position: 1
                          home:
                            games_played: 17
                            won: 13
                            draw: 2
                            lost: 2
                            goals_diff: 38
                            goals_scored: 53
                            goals_against: 15
                            points: 41
                            position: 1
                          away:
                            games_played: 17
                            won: 13
                            draw: 2
                            lost: 2
                            goals_diff: 30
                            goals_scored: 47
                            goals_against: 17
                            points: 41
                            position: 1
                          total: 34
                          status: Promotion
                          result: Champions League
                          points: 82
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                cup_draw:
                  summary: Cup draw (tournament bracket)
                  value:
                    data: []
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: 0
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/teams/:
    get:
      summary: Teams
      operationId: getTeams
      tags:
        - Teams
      description: |
        Team profiles, lists, squads, transfers, sidelined players and trophies. A team profile carries its seasons and the leagues it takes part in.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `info` | Team by ID. Team profile with venue, coach, kit colours, seasons and leagues. | `id` | — |
        | `list` | Teams by country. Paginated, 100 items per page. | `country_id` | `page` |
        | `sort` | Teams by multiple IDs. Several team profiles in one request. | `ids` | — |
        | `byseason` | Teams by season. Teams taking part in a season. | `season_id` | — |
        | `national` | National teams. Paginated, 100 items per page. | — | `page` |
        | `squad` | Team squad. Current squad, or the squad of a past season when `season_id` is given. | `id` | `season_id` |
        | `transfers` | Team transfers. Arrivals and departures with fee and date. | `id` | — |
        | `sidelined` | Team sidelined players. Injured and suspended players. | `id` | — |
        | `trophies` | Team trophies. Titles won by the team, with the seasons of each one. | `id` | — |

        ## Examples

        Team by ID:

        ```http
        GET /v2.2/teams/?user=USER&token=TOKEN&t=info&id=111
        ```

        Teams by country:

        ```http
        GET /v2.2/teams/?user=USER&token=TOKEN&t=list&country_id=4
        ```

        Teams by multiple IDs:

        ```http
        GET /v2.2/teams/?user=USER&token=TOKEN&t=sort&ids=19,99,108
        ```

        Teams by season:

        ```http
        GET /v2.2/teams/?user=USER&token=TOKEN&t=byseason&season_id=13480
        ```

        National teams:

        ```http
        GET /v2.2/teams/?user=USER&token=TOKEN&t=national
        ```

        Team squad:

        ```http
        GET /v2.2/teams/?user=USER&token=TOKEN&t=squad&id=2868
        ```

        Team transfers:

        ```http
        GET /v2.2/teams/?user=USER&token=TOKEN&t=transfers&id=111
        ```

        Team sidelined players:

        ```http
        GET /v2.2/teams/?user=USER&token=TOKEN&t=sidelined&id=111
        ```

        Team trophies:

        ```http
        GET /v2.2/teams/?user=USER&token=TOKEN&t=trophies&id=111
        ```
      x-operations:
        - t: info
          title: Team by ID
          purpose: Team profile with venue, coach, kit colours, seasons and leagues.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=111
        - t: list
          title: Teams by country
          purpose: Paginated, 100 items per page.
          required:
            - country_id
          optional:
            - page
          schema: DataResponse
          paginated: true
          example: country_id=4
        - t: sort
          title: Teams by multiple IDs
          purpose: Several team profiles in one request.
          required:
            - ids
          optional: []
          schema: DataResponse
          example: ids=19,99,108
        - t: byseason
          title: Teams by season
          purpose: Teams taking part in a season.
          required:
            - season_id
          optional: []
          schema: DataResponse
          example: season_id=13480
        - t: national
          title: National teams
          purpose: Paginated, 100 items per page.
          required: []
          optional:
            - page
          schema: DataResponse
          paginated: true
          example: ''
        - t: squad
          title: Team squad
          purpose: Current squad, or the squad of a past season when `season_id` is given.
          required:
            - id
          optional:
            - season_id
          schema: DataResponse
          example: id=2868
        - t: transfers
          title: Team transfers
          purpose: Arrivals and departures with fee and date.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=111
        - t: sidelined
          title: Team sidelined players
          purpose: Injured and suspended players.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=111
        - t: trophies
          title: Team trophies
          purpose: Titles won by the team, with the seasons of each one.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=111
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: info
          schema:
            type: string
            enum:
              - info
              - list
              - sort
              - byseason
              - national
              - squad
              - transfers
              - sidelined
              - trophies
            x-enumDescriptions:
              info: Team by ID
              list: Teams by country
              sort: Teams by multiple IDs
              byseason: Teams by season
              national: National teams
              squad: Team squad
              transfers: Team transfers
              sidelined: Team sidelined players
              trophies: Team trophies
        - name: id
          in: query
          required: false
          description: Team ID. Required when `t` is `info`, `squad`, `transfers`, `sidelined`, `trophies`.
          schema:
            type: string
          example: '111'
        - name: ids
          in: query
          required: false
          description: Comma-separated team IDs, without spaces. Required when `t` is `sort`.
          schema:
            type: string
          example: 19,99,108
        - name: country_id
          in: query
          required: false
          description: Country ID. Required when `t` is `list`.
          schema:
            type: string
          example: '4'
        - name: season_id
          in: query
          required: false
          description: Season ID. Required when `t` is `byseason`. Optional for `squad`.
          schema:
            type: string
          example: '13480'
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                info:
                  summary: Team by ID
                  value:
                    data:
                      id: 111
                      common_name: Bayern Munich
                      name: FC Bayern Munich
                      short_code: BMU
                      is_national: 0
                      img: https://cdn.soccersapi.com/images/soccer/teams/100/111.png
                      current_seasons:
                        - 21268
                      leagues:
                        - id: '594'
                          name: Bundesliga
                          is_cup: '0'
                          is_amateur: '0'
                          is_friendly: '0'
                          current_season_id: '21268'
                          seasons:
                            - id: 21268
                              name: 26/27
                              is_current: 1
                      founded: '1900'
                      twitter: FCBayern
                      coach_id: 5992
                      venue_id: 1446
                      kit:
                        - type: home
                          colors:
                            shirt: '#f23a3a'
                            sleeve: '#ffffff'
                            number: '#ffffff'
                      country:
                        id: 4
                        name: Germany
                        cc: de
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                list:
                  summary: Teams by country
                  value:
                    data:
                      - id: 98
                        name: Borussia Dortmund
                        country_id: '4'
                        country:
                          id: 4
                          name: Germany
                          cc: de
                      - id: 101
                        name: RB Leipzig
                        country_id: '4'
                        country:
                          id: 4
                          name: Germany
                          cc: de
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 8
                      count: 100
                      total: 746
                      msg: ''
                sort:
                  summary: Teams by multiple IDs
                  value:
                    data:
                      - id: 19
                        common_name: Manchester United
                        name: Manchester United
                        short_code: MUN
                        is_national: 0
                        img: https://cdn.soccersapi.com/images/soccer/teams/100/19.png
                        current_seasons:
                          - 21033
                        leagues:
                          - id: '583'
                            name: Premier League
                            is_cup: '0'
                            is_amateur: '0'
                            is_friendly: '0'
                            current_season_id: '21033'
                            seasons:
                              - id: 21033
                                name: 26/27
                                is_current: 1
                        founded: '1878'
                        twitter: ManUtd
                        coach_id: 7681
                        venue_id: 1878
                        kit:
                          - type: home
                            colors:
                              shirt: '#ea0000'
                              sleeve: '#000000'
                              sleeve_detail: '#ea0000'
                              number: '#ffffff'
                        country:
                          id: 3
                          name: England
                          cc: en
                      - id: 99
                        common_name: Barcelona
                        name: FC Barcelona
                        short_code: BAR
                        is_national: 0
                        img: https://cdn.soccersapi.com/images/soccer/teams/100/99.png
                        current_seasons:
                          - 21233
                        leagues:
                          - id: '637'
                            name: LaLiga
                            is_cup: '0'
                            is_amateur: '0'
                            is_friendly: '0'
                            current_season_id: '21233'
                            seasons:
                              - id: 21233
                                name: 26/27
                                is_current: 1
                        founded: '1899'
                        twitter: FCBarcelona
                        coach_id: 662
                        venue_id: 86
                        kit:
                          - type: home
                            colors:
                              shirt: '#282e60'
                              sleeve: '#0d0d0d'
                              number: '#efc006'
                        country:
                          id: 5
                          name: Spain
                          cc: es
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 3
                      total: 3
                      msg: ''
                byseason:
                  summary: Teams by season
                  value:
                    data:
                      - id: 2810
                        name: Werder Bremen
                        country_id: 4
                      - id: 111
                        name: FC Bayern Munich
                        country_id: 4
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 19
                      total: 19
                      msg: ''
                national:
                  summary: National teams
                  value:
                    data:
                      - id: 21
                        name: Turkey
                        country_id: 1
                      - id: 22
                        name: Italy
                        country_id: 1
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 13
                      count: 100
                      total: 1231
                      msg: ''
                squad:
                  summary: Team squad
                  value:
                    data:
                      formation: null
                      squad:
                        - player:
                            id: 28581448
                            name: Savic
                            common_name: ''
                            firstname: Savic
                            lastname: ' Sergej'
                            weight: null
                            height: 186
                            age: 18
                            img: https://cdn.soccersapi.com/images/soccer/players/50/28581448.png
                            country:
                              id: 15
                              name: Austria
                              cc: at
                          number: 3
                          captain: null
                          position: D
                          order: null
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                transfers:
                  summary: Team transfers
                  value:
                    data:
                      arrivals:
                        - player:
                            id: null
                            name: Noel Aseko
                          type: Buy
                          date: null
                          fee: €2.50m
                          team_left:
                            id: 2850
                            name: Hannover 96
                      departures:
                        - player:
                            id: 30733
                            name: Daniel Peretz
                          type: Sell
                          date: null
                          fee: €8.00m
                          team_join:
                            id: 8
                            name: Southampton
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                sidelined:
                  summary: Team sidelined players
                  value:
                    data:
                      id: 111
                      name: Bayern Munich
                      types:
                        injuries:
                          - player:
                              id: 17326
                              name: Davies, Alphonso
                            reason: Injured
                            since: '2026-05-08'
                            expected_return: '?'
                        suspension: []
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                trophies:
                  summary: Team trophies
                  value:
                    data:
                      season_id: null
                      trophies:
                        - id: 746
                          name: German Super Cup Winner
                          seasons:
                            - 25/26
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 25
                      total: 25
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/seasons/:
    get:
      summary: Seasons
      operationId: getSeasons
      tags:
        - Competitions
      description: |
        Season details. Season IDs come from a league profile (`leagues?t=info`) and are the key for fixtures, standings, teams, statistics and leaders.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `info` | Season by ID. One season with its dates, league, stages, rounds and current stage and round. | `id` | — |

        ## Examples

        Season by ID:

        ```http
        GET /v2.2/seasons/?user=USER&token=TOKEN&t=info&id=406
        ```
      x-operations:
        - t: info
          title: Season by ID
          purpose: One season with its dates, league, stages, rounds and current stage and round.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=406
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: info
          schema:
            type: string
            enum:
              - info
            x-enumDescriptions:
              info: Season by ID
        - name: id
          in: query
          required: true
          description: Season ID. Required by every operation.
          schema:
            type: string
          example: '406'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                info:
                  summary: Season by ID
                  value:
                    data:
                      id: 406
                      name: 19/20
                      is_current: 0
                      start: '2019-08-16'
                      end: '2020-07-06'
                      league_id: 594
                      current_round_id: 1994
                      current_stage_id: '1'
                      round_ids:
                        - '1994'
                      stages:
                        - id: 1
                          name: Regular Season
                          is_current: 1
                          has_standings: 1
                          has_cupdraw: 1
                      order: 57
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/stages/:
    get:
      summary: Stages
      operationId: getStages
      tags:
        - Competitions
      description: |
        Stages of a season, such as regular season, play-offs or knockout rounds.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `byseason` | Stages by season. Stages of a season, flagged with whether they have standings or a cup draw. | `season_id` | — |
        | `info` | Stage by ID. One stage. | `id` | — |

        ## Examples

        Stages by season:

        ```http
        GET /v2.2/stages/?user=USER&token=TOKEN&t=byseason&season_id=2091
        ```

        Stage by ID:

        ```http
        GET /v2.2/stages/?user=USER&token=TOKEN&t=info&id=26
        ```
      x-operations:
        - t: byseason
          title: Stages by season
          purpose: Stages of a season, flagged with whether they have standings or a cup draw.
          required:
            - season_id
          optional: []
          schema: DataResponse
          example: season_id=2091
        - t: info
          title: Stage by ID
          purpose: One stage.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=26
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: byseason
          schema:
            type: string
            enum:
              - byseason
              - info
            x-enumDescriptions:
              byseason: Stages by season
              info: Stage by ID
        - name: id
          in: query
          required: false
          description: Stage ID. Required when `t` is `info`.
          schema:
            type: string
          example: '26'
        - name: season_id
          in: query
          required: false
          description: Season ID. Required when `t` is `byseason`.
          schema:
            type: string
          example: '2091'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                byseason:
                  summary: Stages by season
                  value:
                    data:
                      - id: 20
                        name: Conference
                        is_current: 1
                        has_standings: 1
                        has_cupdraw: 1
                      - id: 6
                        name: Group stage
                        is_current: 0
                        has_standings: 1
                        has_cupdraw: 1
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 3
                      total: 3
                      msg: ''
                info:
                  summary: Stage by ID
                  value:
                    data:
                      id: '26'
                      name: Knockout
                      has_standings: null
                      has_cupdraw: null
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/groups/:
    get:
      summary: Groups
      operationId: getGroups
      tags:
        - Competitions
      description: |
        Groups of a season for competitions with a group phase.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `byseason` | Groups by season. Groups of a season, listed under their stage. | `season_id` | — |
        | `info` | Group by ID. One group. | `id` | — |

        ## Examples

        Groups by season:

        ```http
        GET /v2.2/groups/?user=USER&token=TOKEN&t=byseason&season_id=7011
        ```

        Group by ID:

        ```http
        GET /v2.2/groups/?user=USER&token=TOKEN&t=info&id=5108
        ```
      x-operations:
        - t: byseason
          title: Groups by season
          purpose: Groups of a season, listed under their stage.
          required:
            - season_id
          optional: []
          schema: DataResponse
          example: season_id=7011
        - t: info
          title: Group by ID
          purpose: One group.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=5108
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: byseason
          schema:
            type: string
            enum:
              - byseason
              - info
            x-enumDescriptions:
              byseason: Groups by season
              info: Group by ID
        - name: id
          in: query
          required: false
          description: Group ID. Required when `t` is `info`.
          schema:
            type: string
          example: '5108'
        - name: season_id
          in: query
          required: false
          description: Season ID. Required when `t` is `byseason`.
          schema:
            type: string
          example: '7011'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                byseason:
                  summary: Groups by season
                  value:
                    data:
                      - stage_id: 2
                        stage_name: Playoffs
                        groups:
                          - id: 200
                            name: Knockout stage
                      - stage_id: 6
                        stage_name: Group stage
                        groups:
                          - id: 2065
                            name: A
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 3
                      total: 3
                      msg: ''
                info:
                  summary: Group by ID
                  value:
                    data:
                      id: '5108'
                      name: Pro League 22/23
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/rounds/:
    get:
      summary: Rounds
      operationId: getRounds
      tags:
        - Competitions
      description: |
        Rounds (match days) of a season.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `byseason` | Rounds by season. Rounds of a season with the current one flagged. | `season_id` | — |
        | `info` | Round by ID. One round. | `id` | — |

        ## Examples

        Rounds by season:

        ```http
        GET /v2.2/rounds/?user=USER&token=TOKEN&t=byseason&season_id=406
        ```

        Round by ID:

        ```http
        GET /v2.2/rounds/?user=USER&token=TOKEN&t=info&id=1994
        ```
      x-operations:
        - t: byseason
          title: Rounds by season
          purpose: Rounds of a season with the current one flagged.
          required:
            - season_id
          optional: []
          schema: DataResponse
          example: season_id=406
        - t: info
          title: Round by ID
          purpose: One round.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=1994
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: byseason
          schema:
            type: string
            enum:
              - byseason
              - info
            x-enumDescriptions:
              byseason: Rounds by season
              info: Round by ID
        - name: id
          in: query
          required: false
          description: Round ID. Required when `t` is `info`.
          schema:
            type: string
          example: '1994'
        - name: season_id
          in: query
          required: false
          description: Season ID. Required when `t` is `byseason`.
          schema:
            type: string
          example: '406'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                byseason:
                  summary: Rounds by season
                  value:
                    data:
                      - id: 1994
                        name: '1'
                        league_id: 594
                        season_id: 406
                        is_current: 1
                      - id: 1995
                        name: '2'
                        league_id: 594
                        season_id: 406
                        is_current: 0
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 35
                      total: 35
                      msg: ''
                info:
                  summary: Round by ID
                  value:
                    data:
                      id: '1994'
                      name: '1'
                      league_id: '594'
                      season_id: '406'
                      is_current: 1
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/livescores/:
    get:
      summary: Livescores
      operationId: getLivescores
      tags:
        - Livescores
      description: |
        Match feeds for matches in play and for the current, previous and next day. Every feed returns match objects with status, clock, scores, teams and league, and can embed datasets through `include`.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `live` | Matches in play. Paginated, 100 items per page. | — | `include`, `utc`, `lang`, `odds_format`, `page` |
        | `today` | Today's matches. Paginated, 100 items per page. | — | `include`, `utc`, `lang`, `odds_format`, `page` |
        | `tomorrow` | Tomorrow's matches. Paginated, 100 items per page. | — | `include`, `utc`, `lang`, `odds_format`, `page` |
        | `yesterday` | Yesterday's matches. Paginated, 100 items per page. | — | `include`, `utc`, `lang`, `odds_format`, `page` |
        | `notstarted` | Today's matches not started. Paginated, 100 items per page. | — | `include`, `utc`, `lang`, `odds_format`, `page` |
        | `ended` | Today's matches ended. Paginated, 100 items per page. | — | `include`, `utc`, `lang`, `odds_format`, `page` |

        ## Includes

        Comma-separated dataset names for `include`, without spaces:

        - `events`: match timeline (goals, cards, substitutions); see the Match Events guide
        - `stats`: team match statistics, one entry per team
        - `odds_prematch`: pre-match odds where the plan and match coverage provide them (odds theme)
        - `odds_inplay`: in-play odds for matches in play (odds theme)

        ## Live publication behavior

        Scores and event attribution are updated independently. A score change can be visible before the goal event, scorer or assist has been published by the source, and no fixed maximum delay is guaranteed. Keep events on the normal polling cycle: if attribution is incomplete, read it again on the next scheduled poll instead of adding an immediate high-frequency events loop.

        ## Examples

        Matches in play:

        ```http
        GET /v2.2/livescores/?user=USER&token=TOKEN&t=live&include=events,stats
        ```

        Today's matches:

        ```http
        GET /v2.2/livescores/?user=USER&token=TOKEN&t=today&utc=2
        ```

        Tomorrow's matches:

        ```http
        GET /v2.2/livescores/?user=USER&token=TOKEN&t=tomorrow
        ```

        Yesterday's matches:

        ```http
        GET /v2.2/livescores/?user=USER&token=TOKEN&t=yesterday
        ```

        Today's matches not started:

        ```http
        GET /v2.2/livescores/?user=USER&token=TOKEN&t=notstarted
        ```

        Today's matches ended:

        ```http
        GET /v2.2/livescores/?user=USER&token=TOKEN&t=ended
        ```
      x-operations:
        - t: live
          title: Matches in play
          purpose: Paginated, 100 items per page.
          required: []
          optional:
            - include
            - utc
            - lang
            - odds_format
            - page
          schema: MatchListResponse
          paginated: true
          example: include=events,stats
        - t: today
          title: Today's matches
          purpose: Paginated, 100 items per page.
          required: []
          optional:
            - include
            - utc
            - lang
            - odds_format
            - page
          schema: MatchListResponse
          paginated: true
          example: utc=2
        - t: tomorrow
          title: Tomorrow's matches
          purpose: Paginated, 100 items per page.
          required: []
          optional:
            - include
            - utc
            - lang
            - odds_format
            - page
          schema: MatchListResponse
          paginated: true
          example: ''
        - t: yesterday
          title: Yesterday's matches
          purpose: Paginated, 100 items per page.
          required: []
          optional:
            - include
            - utc
            - lang
            - odds_format
            - page
          schema: MatchListResponse
          paginated: true
          example: ''
        - t: notstarted
          title: Today's matches not started
          purpose: Paginated, 100 items per page.
          required: []
          optional:
            - include
            - utc
            - lang
            - odds_format
            - page
          schema: MatchListResponse
          paginated: true
          example: ''
        - t: ended
          title: Today's matches ended
          purpose: Paginated, 100 items per page.
          required: []
          optional:
            - include
            - utc
            - lang
            - odds_format
            - page
          schema: MatchListResponse
          paginated: true
          example: ''
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: live
          schema:
            type: string
            enum:
              - live
              - today
              - tomorrow
              - yesterday
              - notstarted
              - ended
            x-enumDescriptions:
              live: Matches in play
              today: Today's matches
              tomorrow: Tomorrow's matches
              yesterday: Yesterday's matches
              notstarted: Today's matches not started
              ended: Today's matches ended
        - name: include
          in: query
          required: false
          description: 'Comma-separated datasets to embed in the response, without spaces. Supported values: `events`, `stats`, `odds_prematch`, `odds_inplay`. See the includes section.'
          example: events,stats
          schema:
            type: string
        - $ref: '#/components/parameters/Utc'
        - $ref: '#/components/parameters/Lang'
        - $ref: '#/components/parameters/OddsFormat'
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MatchListResponse'
              examples:
                live:
                  summary: Matches in play
                  value:
                    data:
                      - id: 2554966
                        status: 1
                        status_name: Inplay
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '212522'
                        round_name: '18'
                        season_id: '16165'
                        season_name: '2026'
                        stage_id: '2105'
                        stage_name: Regular Season - Superleague, Women 2026
                        group_id: '12943'
                        group_name: Superleague, Women 2026
                        aggregate_id: null
                        winner_team_id: null
                        venue_id: null
                        leg: null
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-04 13:00:00'
                          date: '2026-09-04'
                          time: '13:00:00'
                          minute: null
                          timestamp: 1788526800
                          timezone: UTC
                        teams:
                          home:
                            id: 1192523153
                            name: Zhfk Krylya Sovetov Samara
                            short_code: ZHF
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/1192523153.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 1192523152
                            name: FC Dinamo Moscow
                            short_code: DIN
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/1192523152.png
                            form: null
                            coach_id: null
                            kit_colors:
                              away_main_color: '#585858'
                              away_second_color: '#585858'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#efc131'
                              away_gk_second_color: '#333333'
                              away_gk_number_color: '#000000'
                        league:
                          id: 3218
                          name: Premier League, Women
                          type: Superleague, Women 2026
                          country_id: '100'
                          country_name: Russia
                          country_code: ru
                          country_flag: https://cdn.soccersapi.com/images/countries/30/ru.png
                        scores:
                          home_score: '0'
                          away_score: '1'
                          ht_score: 0-1
                          ft_score: 0-1
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 5
                          away_position: 6
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 1
                        weather_report: null
                        events: []
                        stats:
                          - team_id: 1192523153
                            key_passes: null
                            passing_accuracy: null
                            fouls: null
                            injuries: null
                            corners: null
                            crosses: null
                            crossing_accuracy: null
                            offsides: null
                            shots_total: null
                            shots_on_target: null
                            shots_off_target: null
                            shots_blocked: null
                            possessiontime: null
                            possessionpercent: null
                            yellowcards: null
                            yellowredcards: null
                            redcards: null
                            substitutions: null
                            goal_kick: null
                            goal_attempts: null
                            free_kick: null
                            throw_in: null
                            ball_safe: null
                            goals: null
                            penalties: null
                            attacks: null
                            dangerous_attacks: null
                            action_areas: null
                            xg: null
                      - id: 2623911
                        status: 1
                        status_name: Inplay
                        status_period: 2nd Half
                        pitch: null
                        referee_id: null
                        round_id: null
                        round_name: null
                        season_id: '21185'
                        season_name: '2026'
                        stage_id: '1'
                        stage_name: Regular Season
                        group_id: '13769'
                        group_name: U20 Carioca, Serie A 2026, Taca Guanabara
                        aggregate_id: null
                        winner_team_id: null
                        venue_id: '5034'
                        leg: null
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-04 13:00:00'
                          date: '2026-09-04'
                          time: '13:00:00'
                          minute: '92'
                          timestamp: 1788526800
                          timezone: UTC
                        teams:
                          home:
                            id: 1829638371
                            name: Bangu AC RJ
                            short_code: BAN
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/1829638371.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 7825
                            name: CR Flamengo RJ U20
                            short_code: FLA
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/7825.png
                            form: null
                            coach_id: '9454'
                            kit_colors:
                              away_main_color: '#ff0000'
                              away_second_color: '#000000'
                              away_number_color: '#000000'
                              away_gk_main_color: '#efc131'
                              away_gk_second_color: '#333333'
                              away_gk_number_color: '#000000'
                        league:
                          id: 5548
                          name: U20 Carioca, Serie A
                          type: U20 Carioca, Serie A 2026, Taca Guanabara
                          country_id: '25'
                          country_name: Brazil
                          country_code: br
                          country_flag: https://cdn.soccersapi.com/images/countries/30/br.png
                        scores:
                          home_score: '0'
                          away_score: '2'
                          ht_score: 0-1
                          ft_score: 0-2
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 11
                          away_position: 1
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 1
                        weather_report:
                          desc: clear/sunny
                          temp:
                            celsius: 28.9
                            fahrenheit: 84
                          wind:
                            kmph: 10.6
                            miles: 6.59
                            direction: NW
                          humidity_percent: 52
                          pressure: 1014
                        events:
                          - team_id: 1829638371
                            type: corner
                            period: 1st half
                            player_id: null
                            player_name: null
                            related_player_id: null
                            related_player_name: null
                            minute: '3'
                            extra_minute: null
                            timestamp: null
                            reason: null
                            injuried: null
                            own_goal: false
                            penalty: false
                            result: null
                            info: 1st Corner kick
                        stats:
                          - team_id: 1829638371
                            key_passes: null
                            passing_accuracy: null
                            fouls: null
                            injuries: null
                            corners: '3'
                            crosses: null
                            crossing_accuracy: null
                            offsides: null
                            shots_total: 16
                            shots_on_target: '1'
                            shots_off_target: '15'
                            shots_blocked: null
                            possessiontime: 45
                            possessionpercent: 50
                            yellowcards: '3'
                            yellowredcards: null
                            redcards: '0'
                            substitutions: '3'
                            goal_kick: null
                            goal_attempts: null
                            free_kick: null
                            throw_in: null
                            ball_safe: null
                            goals: 0
                            penalties: '0'
                            attacks: '134'
                            dangerous_attacks: '68'
                            action_areas: null
                            xg: null
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 59
                      total: 59
                      msg: ''
                today:
                  summary: Today's matches
                  value:
                    data:
                      - id: 2665019
                        status: 0
                        status_name: Notstarted
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '222765'
                        round_name: '14'
                        season_id: '21386'
                        season_name: 26/27
                        stage_id: '9'
                        stage_name: Qualification
                        group_id: '14109'
                        group_name: CAF Champions League 26/27, Qualification
                        aggregate_id: null
                        winner_team_id: null
                        venue_id: null
                        leg: 1/2
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-04 19:00:00'
                          date: '2026-09-04'
                          time: '19:00:00'
                          minute: ''
                          timestamp: 1788548400
                          timezone: UTC+2
                        teams:
                          home:
                            id: 28187
                            name: AL Swehly SC
                            short_code: SWE
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/28187.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 59734568
                            name: Kvz
                            short_code: KVZ
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/59734568.png
                            form: null
                            coach_id: null
                            kit_colors:
                              away_main_color: '#585858'
                              away_second_color: '#585858'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#efc131'
                              away_gk_second_color: '#333333'
                              away_gk_number_color: '#000000'
                        league:
                          id: 516
                          name: CAF Champions League
                          type: CAF Champions League 26/27, Qualification
                          country_id: '136'
                          country_name: Africa
                          country_code: null
                          country_flag: null
                        scores:
                          home_score: null
                          away_score: null
                          ht_score: '-'
                          ft_score: '-'
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 0
                          away_position: 0
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 0
                        weather_report: null
                      - id: 2665021
                        status: 0
                        status_name: Notstarted
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '222765'
                        round_name: '14'
                        season_id: '21386'
                        season_name: 26/27
                        stage_id: '9'
                        stage_name: Qualification
                        group_id: '14109'
                        group_name: CAF Champions League 26/27, Qualification
                        aggregate_id: null
                        winner_team_id: null
                        venue_id: null
                        leg: 1/2
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-04 19:00:00'
                          date: '2026-09-04'
                          time: '19:00:00'
                          minute: ''
                          timestamp: 1788548400
                          timezone: UTC+2
                        teams:
                          home:
                            id: 21993
                            name: AS Port
                            short_code: POR
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/21993.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 5183
                            name: Zamalek SC
                            short_code: ZAM
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/5183.png
                            form: null
                            coach_id: '1003'
                            kit_colors:
                              away_main_color: '#000099'
                              away_second_color: '#ffffff'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#000099'
                              away_gk_second_color: '#000099'
                              away_gk_number_color: '#ffffff'
                        league:
                          id: 516
                          name: CAF Champions League
                          type: CAF Champions League 26/27, Qualification
                          country_id: '136'
                          country_name: Africa
                          country_code: null
                          country_flag: null
                        scores:
                          home_score: null
                          away_score: null
                          ht_score: '-'
                          ft_score: '-'
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 0
                          away_position: 0
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 0
                        weather_report: null
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 7
                      count: 100
                      total: 645
                      msg: ''
                tomorrow:
                  summary: Tomorrow's matches
                  value:
                    data:
                      - id: 2665013
                        status: 0
                        status_name: Notstarted
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '222765'
                        round_name: '14'
                        season_id: '21386'
                        season_name: 26/27
                        stage_id: '9'
                        stage_name: Qualification
                        group_id: '14109'
                        group_name: CAF Champions League 26/27, Qualification
                        aggregate_id: null
                        winner_team_id: null
                        venue_id: '9067'
                        leg: 1/2
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-05 13:00:00'
                          date: '2026-09-05'
                          time: '13:00:00'
                          minute: ''
                          timestamp: 1788613200
                          timezone: UTC
                        teams:
                          home:
                            id: 5845
                            name: Aigle Noir CS
                            short_code: AIN
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/5845.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 5848
                            name: AL Hilal (SDN)
                            short_code: HIL
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/5848.png
                            form: null
                            coach_id: null
                            kit_colors:
                              away_main_color: '#0033ff'
                              away_second_color: '#ffffff'
                              away_number_color: '#000000'
                              away_gk_main_color: '#669900'
                              away_gk_second_color: '#000000'
                              away_gk_number_color: '#ffffff'
                        league:
                          id: 516
                          name: CAF Champions League
                          type: CAF Champions League 26/27, Qualification
                          country_id: '136'
                          country_name: Africa
                          country_code: null
                          country_flag: null
                        scores:
                          home_score: null
                          away_score: null
                          ht_score: '-'
                          ft_score: '-'
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 0
                          away_position: 0
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 0
                        weather_report: null
                      - id: 2665022
                        status: 0
                        status_name: Notstarted
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '222765'
                        round_name: '14'
                        season_id: '21386'
                        season_name: 26/27
                        stage_id: '9'
                        stage_name: Qualification
                        group_id: '14109'
                        group_name: CAF Champions League 26/27, Qualification
                        aggregate_id: null
                        winner_team_id: null
                        venue_id: null
                        leg: 1/2
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-05 13:00:00'
                          date: '2026-09-05'
                          time: '13:00:00'
                          minute: ''
                          timestamp: 1788613200
                          timezone: UTC
                        teams:
                          home:
                            id: 1935262293
                            name: Al Merriekh FC Bentiu
                            short_code: MER
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/1935262293.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 28188
                            name: Heegan
                            short_code: HEE
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/28188.png
                            form: null
                            coach_id: null
                            kit_colors:
                              away_main_color: '#585858'
                              away_second_color: '#585858'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#efc131'
                              away_gk_second_color: '#333333'
                              away_gk_number_color: '#000000'
                        league:
                          id: 516
                          name: CAF Champions League
                          type: CAF Champions League 26/27, Qualification
                          country_id: '136'
                          country_name: Africa
                          country_code: null
                          country_flag: null
                        scores:
                          home_score: null
                          away_score: null
                          ht_score: '-'
                          ft_score: '-'
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 0
                          away_position: 0
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 0
                        weather_report: null
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 19
                      count: 100
                      total: 1802
                      msg: ''
                yesterday:
                  summary: Yesterday's matches
                  value:
                    data:
                      - id: 2678164
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '221884'
                        round_name: '1'
                        season_id: '21329'
                        season_name: 26/27
                        stage_id: '1'
                        stage_name: Regular Season
                        group_id: '14009'
                        group_name: Ligue 1 26/27
                        aggregate_id: null
                        winner_team_id: '17295'
                        venue_id: '78'
                        leg: null
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-03 18:00:00'
                          date: '2026-09-03'
                          time: '18:00:00'
                          minute: 90
                          timestamp: 1788458400
                          timezone: UTC
                        teams:
                          home:
                            id: 5362
                            name: ES Setif
                            short_code: ESS
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/5362.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#3366ff'
                              home_gk_second_color: '#3366ff'
                              home_gk_number_color: '#ffffff'
                          away:
                            id: 17295
                            name: Ben Aknoun
                            short_code: BAK
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/17295.png
                            form: null
                            coach_id: null
                            kit_colors:
                              away_main_color: '#585858'
                              away_second_color: '#585858'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#efc131'
                              away_gk_second_color: '#333333'
                              away_gk_number_color: '#000000'
                        league:
                          id: 799
                          name: Ligue 1
                          type: Ligue 1 26/27
                          country_id: '9'
                          country_name: Algeria
                          country_code: dz
                          country_flag: https://cdn.soccersapi.com/images/countries/30/dz.png
                        scores:
                          home_score: '0'
                          away_score: '1'
                          ht_score: 0-0
                          ft_score: 0-1
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 1
                          away_position: 1
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 1
                        weather_report:
                          desc: clear/sunny
                          temp:
                            celsius: 28.9
                            fahrenheit: 84
                          wind:
                            kmph: 12
                            miles: 7.46
                            direction: NNE
                          humidity_percent: 30
                          pressure: 1021
                      - id: 2668002
                        status: 4
                        status_name: Postponed
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '223081'
                        round_name: '2'
                        season_id: '21329'
                        season_name: 26/27
                        stage_id: '1'
                        stage_name: Regular Season
                        group_id: '14009'
                        group_name: Ligue 1 26/27
                        aggregate_id: null
                        winner_team_id: null
                        venue_id: '3133'
                        leg: null
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-03 19:00:00'
                          date: '2026-09-03'
                          time: '19:00:00'
                          minute: null
                          timestamp: 1788462000
                          timezone: UTC
                        teams:
                          home:
                            id: 5371
                            name: MC Oran
                            short_code: MCO
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/5371.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#66ff00'
                              home_gk_second_color: '#000000'
                              home_gk_number_color: '#000000'
                          away:
                            id: 17299
                            name: CR Temouchent
                            short_code: CRT
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/17299.png
                            form: null
                            coach_id: null
                            kit_colors:
                              away_main_color: '#585858'
                              away_second_color: '#585858'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#efc131'
                              away_gk_second_color: '#333333'
                              away_gk_number_color: '#000000'
                        league:
                          id: 799
                          name: Ligue 1
                          type: Ligue 1 26/27
                          country_id: '9'
                          country_name: Algeria
                          country_code: dz
                          country_flag: https://cdn.soccersapi.com/images/countries/30/dz.png
                        scores:
                          home_score: null
                          away_score: null
                          ht_score: '-'
                          ft_score: '-'
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 1
                          away_position: 1
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 1
                        weather_report:
                          desc: partly cloudy
                          temp:
                            celsius: 27.3
                            fahrenheit: 81.1
                          wind:
                            kmph: 4.9
                            miles: 3.04
                            direction: NNE
                          humidity_percent: 89
                          pressure: 1019
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 3
                      count: 100
                      total: 257
                      msg: ''
                notstarted:
                  summary: Today's matches not started
                  value:
                    data:
                      - id: 2665019
                        status: 0
                        status_name: Notstarted
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '222765'
                        round_name: '14'
                        season_id: '21386'
                        season_name: 26/27
                        stage_id: '9'
                        stage_name: Qualification
                        group_id: '14109'
                        group_name: CAF Champions League 26/27, Qualification
                        aggregate_id: null
                        winner_team_id: null
                        venue_id: null
                        leg: 1/2
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-04 17:00:00'
                          date: '2026-09-04'
                          time: '17:00:00'
                          minute: ''
                          timestamp: 1788541200
                          timezone: UTC
                        teams:
                          home:
                            id: 28187
                            name: AL Swehly SC
                            short_code: SWE
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/28187.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 59734568
                            name: Kvz
                            short_code: KVZ
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/59734568.png
                            form: null
                            coach_id: null
                            kit_colors:
                              away_main_color: '#585858'
                              away_second_color: '#585858'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#efc131'
                              away_gk_second_color: '#333333'
                              away_gk_number_color: '#000000'
                        league:
                          id: 516
                          name: CAF Champions League
                          type: CAF Champions League 26/27, Qualification
                          country_id: '136'
                          country_name: Africa
                          country_code: null
                          country_flag: null
                        scores:
                          home_score: null
                          away_score: null
                          ht_score: '-'
                          ft_score: '-'
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 0
                          away_position: 0
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 0
                        weather_report: null
                      - id: 2665021
                        status: 0
                        status_name: Notstarted
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '222765'
                        round_name: '14'
                        season_id: '21386'
                        season_name: 26/27
                        stage_id: '9'
                        stage_name: Qualification
                        group_id: '14109'
                        group_name: CAF Champions League 26/27, Qualification
                        aggregate_id: null
                        winner_team_id: null
                        venue_id: null
                        leg: 1/2
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-04 17:00:00'
                          date: '2026-09-04'
                          time: '17:00:00'
                          minute: ''
                          timestamp: 1788541200
                          timezone: UTC
                        teams:
                          home:
                            id: 21993
                            name: AS Port
                            short_code: POR
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/21993.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 5183
                            name: Zamalek SC
                            short_code: ZAM
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/5183.png
                            form: null
                            coach_id: '1003'
                            kit_colors:
                              away_main_color: '#000099'
                              away_second_color: '#ffffff'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#000099'
                              away_gk_second_color: '#000099'
                              away_gk_number_color: '#ffffff'
                        league:
                          id: 516
                          name: CAF Champions League
                          type: CAF Champions League 26/27, Qualification
                          country_id: '136'
                          country_name: Africa
                          country_code: null
                          country_flag: null
                        scores:
                          home_score: null
                          away_score: null
                          ht_score: '-'
                          ft_score: '-'
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 0
                          away_position: 0
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 0
                        weather_report: null
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 5
                      count: 100
                      total: 408
                      msg: ''
                ended:
                  summary: Today's matches ended
                  value:
                    data:
                      - id: 2672759
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '223566'
                        round_name: '6'
                        season_id: '21094'
                        season_name: 26/27
                        stage_id: '1'
                        stage_name: Regular Season
                        group_id: '13691'
                        group_name: Premier League 26/27
                        aggregate_id: null
                        winner_team_id: '0'
                        venue_id: '2967'
                        leg: null
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-04 12:00:00'
                          date: '2026-09-04'
                          time: '12:00:00'
                          minute: 90
                          timestamp: 1788523200
                          timezone: UTC
                        teams:
                          home:
                            id: 703569628
                            name: FC Syunik
                            short_code: SYU
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/703569628.png
                            form: null
                            coach_id: '8843'
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 4390
                            name: FC Pyunik Yerevan
                            short_code: PYU
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/4390.png
                            form: null
                            coach_id: '1262'
                            kit_colors:
                              away_main_color: '#b20016'
                              away_second_color: '#d8924e'
                              away_number_color: '#d99349'
                              away_gk_main_color: '#000000'
                              away_gk_second_color: '#000000'
                              away_gk_number_color: '#ffffff'
                        league:
                          id: 865
                          name: Premier League
                          type: Premier League 26/27
                          country_id: '13'
                          country_name: Armenia
                          country_code: am
                          country_flag: https://cdn.soccersapi.com/images/countries/30/am.png
                        scores:
                          home_score: '0'
                          away_score: '0'
                          ht_score: 0-0
                          ft_score: 0-0
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 11
                          away_position: 4
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 1
                        weather_report:
                          desc: clear/sunny
                          temp:
                            celsius: 27
                            fahrenheit: 80.6
                          wind:
                            kmph: 12.7
                            miles: 7.89
                            direction: E
                          humidity_percent: 33
                          pressure: 1013
                      - id: 2680483
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '224148'
                        round_name: Final
                        season_id: '20968'
                        season_name: '2026'
                        stage_id: '12'
                        stage_name: Relegation Playoffs
                        group_id: '14272'
                        group_name: NSW League One 2026, Rel/Prom Playoffs
                        aggregate_id: null
                        winner_team_id: '16110'
                        venue_id: '7440'
                        leg: 1/2
                        week: '36'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-09-04 09:30:00'
                          date: '2026-09-04'
                          time: '09:30:00'
                          minute: 90
                          timestamp: 1788514200
                          timezone: UTC
                        teams:
                          home:
                            id: 16110
                            name: Parramatta FC Eagles
                            short_code: PAR
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/16110.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 22785
                            name: Prospect United
                            short_code: PRO
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/22785.png
                            form: null
                            coach_id: null
                            kit_colors:
                              away_main_color: '#585858'
                              away_second_color: '#585858'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#efc131'
                              away_gk_second_color: '#333333'
                              away_gk_number_color: '#000000'
                        league:
                          id: 6115
                          name: NSW League One
                          type: NSW League One 2026, Rel/Prom Playoffs
                          country_id: '14'
                          country_name: Australia
                          country_code: au
                          country_flag: https://cdn.soccersapi.com/images/countries/30/au.png
                        scores:
                          home_score: '4'
                          away_score: '1'
                          ht_score: 1-0
                          ft_score: 4-1
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 0
                          away_position: 15
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 1
                        weather_report: null
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 90
                      total: 90
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/fixtures/:
    get:
      summary: Fixtures and match datasets
      operationId: getFixtures
      tags:
        - Fixtures
      description: |
        Fixture lists by date, season, round, team or TV channel, single match details and the per-match datasets: events, lineups, bench, commentary, sidelined players and odds. Match-returning operations accept `include` to embed datasets in the match objects.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored. The theme column marks datasets that themed plans (Odds, Broadcast) include only for their own theme; Free and Standard plans include every theme for their leagues.

        | `t` | Operation | Required | Optional | Theme |
        | --- | --- | --- | --- | --- |
        | `schedule` | Fixtures by date. Matches on a date, optionally narrowed to a country, league, season, stage, group or round. Paginated, 100 items per page. | `d` | `country_id`, `league_id`, `season_id`, `stage_id`, `group_id`, `round_id`, `include`, `utc`, `lang`, `odds_format`, `page` | core |
        | `season` | Fixtures by season. Every match of a season in one response, optionally narrowed to a stage, group or team. | `season_id` | `stage_id`, `group_id`, `team_id`, `include`, `utc`, `lang`, `odds_format` | core |
        | `round` | Fixtures by round. Every match of a round, optionally narrowed to a team. | `round_id` | `team_id`, `include`, `utc`, `lang`, `odds_format` | core |
        | `last_next` | Team last and next fixtures. Recent results (`last`), matches in play (`current`) and upcoming matches (`next`) of a team. Does not accept `include`. | `team_id` | `utc`, `lang` | core |
        | `tv` | Fixtures by TV channel. Matches scheduled on a TV channel over the next two weeks. | `tv_id` | `include`, `utc`, `lang` | broadcast |
        | `info` | Match by ID. One match with teams, league, venue, scores, status and clock. | `id` | `include`, `utc`, `lang`, `odds_format` | core |
        | `sort` | Matches by multiple IDs. Several matches in one request, for example to refresh the matches shown on screen. | `ids` | `include`, `utc`, `lang` | core |
        | `match_events` | Match events. Standalone event timeline of one match. | `id` | — | core |
        | `match_lineups` | Match lineups. Formations and starting lineups with position and shirt number. | `id` | `lang` | core |
        | `match_bench` | Match bench. Substitutes of both teams with shirt number and position. | `id` | — | core |
        | `match_comments` | Match commentary. Text commentary of the match where covered. | `id` | `lang` | core |
        | `match_sidelined` | Match sidelined players. Injured and suspended players of both teams. | `id` | — | core |
        | `match_odds` | Pre-match odds. Pre-match odds by bookmaker and market. | `id` | `odds_format` | odds |
        | `match_oddsinplay` | In-play odds. Live odds by market and bookmaker, with the score and minute they refer to. | `id` | `odds_format` | odds |
        | `match_odds_info` | Match odds by bookmaker. Odds history of one bookmaker for the match, by market. | `id`, `bookmaker_id` | `odds_format` | odds |

        ## Includes

        Comma-separated dataset names for `include`, without spaces:

        - `events`: match timeline; supported by `schedule`, `season`, `round`, `info` and `sort`
        - `stats`: team match statistics, one entry per team
        - `broadcast`: TV channels showing the match (broadcast theme)
        - `odds_prematch`: pre-match odds (odds theme)
        - `odds_inplay`: in-play odds for matches in play (odds theme)

        The release notes announce `include=stats` on `match_lineups` for per-player statistics; verification on 2026-09-04 returned no extra data, so it is not documented as a parameter. The `order` parameter shown in the public reference has no effect either. The match-detail operation is `t=info`; `match_by_id` is not a valid value and `/v2.2/matches/` is not a v2.2 route. Dataset names such as `events` belong in `include`; `match_events` is an operation, not an include value. IDs can be JSON numbers or numeric strings depending on the operation: treat them as opaque and normalize before strict comparisons.

        ## Examples

        Fixtures by date:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=schedule&d=2026-08-30&include=broadcast&utc=2
        ```

        Fixtures by season:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=season&season_id=7194&team_id=111&order=asc
        ```

        Fixtures by round:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=round&round_id=1994
        ```

        Team last and next fixtures:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=last_next&team_id=99
        ```

        Fixtures by TV channel:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=tv&tv_id=30
        ```

        Match by ID:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=info&id=2589310&include=events,stats
        ```

        Matches by multiple IDs:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=sort&ids=2589310,2589313&include=events
        ```

        Match events:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_events&id=2589310
        ```

        Match lineups:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_lineups&id=2589310&include=stats
        ```

        Match bench:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_bench&id=2589310
        ```

        Match commentary:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_comments&id=2589310
        ```

        Match sidelined players:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_sidelined&id=2589310
        ```

        Pre-match odds:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_odds&id=2589310
        ```

        In-play odds:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_oddsinplay&id=2589310
        ```

        Match odds by bookmaker:

        ```http
        GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_odds_info&id=2589310&bookmaker_id=1
        ```
      x-operations:
        - t: schedule
          title: Fixtures by date
          purpose: Matches on a date, optionally narrowed to a country, league, season, stage, group or round. Paginated, 100 items per page.
          required:
            - d
          optional:
            - country_id
            - league_id
            - season_id
            - stage_id
            - group_id
            - round_id
            - include
            - utc
            - lang
            - odds_format
            - page
          schema: MatchListResponse
          paginated: true
          example: d=2026-08-30&include=broadcast&utc=2
        - t: season
          title: Fixtures by season
          purpose: Every match of a season in one response, optionally narrowed to a stage, group or team.
          required:
            - season_id
          optional:
            - stage_id
            - group_id
            - team_id
            - include
            - utc
            - lang
            - odds_format
          schema: MatchListResponse
          example: season_id=7194&team_id=111&order=asc
        - t: round
          title: Fixtures by round
          purpose: Every match of a round, optionally narrowed to a team.
          required:
            - round_id
          optional:
            - team_id
            - include
            - utc
            - lang
            - odds_format
          schema: MatchListResponse
          example: round_id=1994
        - t: last_next
          title: Team last and next fixtures
          purpose: Recent results (`last`), matches in play (`current`) and upcoming matches (`next`) of a team. Does not accept `include`.
          required:
            - team_id
          optional:
            - utc
            - lang
          schema: DataResponse
          example: team_id=99
        - t: tv
          title: Fixtures by TV channel
          purpose: Matches scheduled on a TV channel over the next two weeks.
          required:
            - tv_id
          optional:
            - include
            - utc
            - lang
          schema: MatchListResponse
          theme: broadcast
          example: tv_id=30
        - t: info
          title: Match by ID
          purpose: One match with teams, league, venue, scores, status and clock.
          required:
            - id
          optional:
            - include
            - utc
            - lang
            - odds_format
          schema: MatchDetailResponse
          example: id=2589310&include=events,stats
        - t: sort
          title: Matches by multiple IDs
          purpose: Several matches in one request, for example to refresh the matches shown on screen.
          required:
            - ids
          optional:
            - include
            - utc
            - lang
          schema: MatchListResponse
          example: ids=2589310,2589313&include=events
        - t: match_events
          title: Match events
          purpose: Standalone event timeline of one match.
          required:
            - id
          optional: []
          schema: MatchEventsResponse
          example: id=2589310
        - t: match_lineups
          title: Match lineups
          purpose: Formations and starting lineups with position and shirt number.
          required:
            - id
          optional:
            - lang
          schema: LineupsResponse
          example: id=2589310&include=stats
        - t: match_bench
          title: Match bench
          purpose: Substitutes of both teams with shirt number and position.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=2589310
        - t: match_comments
          title: Match commentary
          purpose: Text commentary of the match where covered.
          required:
            - id
          optional:
            - lang
          schema: DataResponse
          example: id=2589310
        - t: match_sidelined
          title: Match sidelined players
          purpose: Injured and suspended players of both teams.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=2589310
        - t: match_odds
          title: Pre-match odds
          purpose: Pre-match odds by bookmaker and market.
          required:
            - id
          optional:
            - odds_format
          schema: MatchOddsResponse
          theme: odds
          example: id=2589310
        - t: match_oddsinplay
          title: In-play odds
          purpose: Live odds by market and bookmaker, with the score and minute they refer to.
          required:
            - id
          optional:
            - odds_format
          schema: MatchOddsResponse
          theme: odds
          example: id=2589310
        - t: match_odds_info
          title: Match odds by bookmaker
          purpose: Odds history of one bookmaker for the match, by market.
          required:
            - id
            - bookmaker_id
          optional:
            - odds_format
          schema: DataResponse
          theme: odds
          example: id=2589310&bookmaker_id=1
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: schedule
          schema:
            type: string
            enum:
              - schedule
              - season
              - round
              - last_next
              - tv
              - info
              - sort
              - match_events
              - match_lineups
              - match_bench
              - match_comments
              - match_sidelined
              - match_odds
              - match_oddsinplay
              - match_odds_info
            x-enumDescriptions:
              schedule: Fixtures by date
              season: Fixtures by season
              round: Fixtures by round
              last_next: Team last and next fixtures
              tv: Fixtures by TV channel
              info: Match by ID
              sort: Matches by multiple IDs
              match_events: Match events
              match_lineups: Match lineups
              match_bench: Match bench
              match_comments: Match commentary
              match_sidelined: Match sidelined players
              match_odds: Pre-match odds
              match_oddsinplay: In-play odds
              match_odds_info: Match odds by bookmaker
        - name: id
          in: query
          required: false
          description: Match ID. Required when `t` is `info`, `match_events`, `match_lineups`, `match_bench`, `match_comments`, `match_sidelined`, `match_odds`, `match_oddsinplay`, `match_odds_info`.
          schema:
            type: string
          example: '2589310'
        - name: ids
          in: query
          required: false
          description: Comma-separated match IDs, without spaces. Required when `t` is `sort`.
          schema:
            type: string
          example: 2589310,2589313
        - name: d
          in: query
          required: false
          description: Calendar date in `YYYY-MM-DD` format, interpreted in the `utc` offset when given. Any other format returns `400`. Required when `t` is `schedule`.
          schema:
            type: string
            format: date
          example: '2026-08-30'
        - name: season_id
          in: query
          required: false
          description: Season ID. Required when `t` is `season`. Optional for `schedule`.
          schema:
            type: string
          example: '7194'
        - name: stage_id
          in: query
          required: false
          description: Stage ID. Optional for `schedule`, `season`.
          schema:
            type: string
          example: '6'
        - name: group_id
          in: query
          required: false
          description: Group ID. Optional for `schedule`, `season`.
          schema:
            type: string
          example: '308'
        - name: round_id
          in: query
          required: false
          description: Round ID. Required when `t` is `round`. Optional for `schedule`.
          schema:
            type: string
          example: '1994'
        - name: team_id
          in: query
          required: false
          description: Team ID. Required when `t` is `last_next`. Optional for `season`, `round`.
          schema:
            type: string
          example: '111'
        - name: league_id
          in: query
          required: false
          description: League ID. Optional for `schedule`.
          schema:
            type: string
          example: '594'
        - name: country_id
          in: query
          required: false
          description: Country ID. Optional for `schedule`.
          schema:
            type: string
          example: '4'
        - name: tv_id
          in: query
          required: false
          description: TV channel ID. Required when `t` is `tv`.
          schema:
            type: string
          example: '30'
        - name: bookmaker_id
          in: query
          required: false
          description: Bookmaker ID. Required when `t` is `match_odds_info`.
          schema:
            type: string
          example: '1'
        - name: include
          in: query
          required: false
          description: 'Comma-separated datasets to embed in the response, without spaces. Supported values: `events`, `stats`, `broadcast`, `odds_prematch`, `odds_inplay`. See the includes section.'
          example: events,stats
          schema:
            type: string
        - $ref: '#/components/parameters/Utc'
        - $ref: '#/components/parameters/Lang'
        - $ref: '#/components/parameters/OddsFormat'
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: |-
            The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.

            - `t=schedule`: MatchListResponse
            - `t=season`: MatchListResponse
            - `t=round`: MatchListResponse
            - `t=last_next`: DataResponse
            - `t=tv`: MatchListResponse
            - `t=info`: MatchDetailResponse
            - `t=sort`: MatchListResponse
            - `t=match_events`: MatchEventsResponse
            - `t=match_lineups`: LineupsResponse
            - `t=match_bench`: DataResponse
            - `t=match_comments`: DataResponse
            - `t=match_sidelined`: DataResponse
            - `t=match_odds`: MatchOddsResponse
            - `t=match_oddsinplay`: MatchOddsResponse
            - `t=match_odds_info`: DataResponse
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/MatchListResponse'
                  - $ref: '#/components/schemas/DataResponse'
                  - $ref: '#/components/schemas/MatchDetailResponse'
                  - $ref: '#/components/schemas/MatchEventsResponse'
                  - $ref: '#/components/schemas/LineupsResponse'
                  - $ref: '#/components/schemas/MatchOddsResponse'
              examples:
                schedule:
                  summary: Fixtures by date
                  value:
                    data:
                      - id: 2638183
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '220776'
                        round_name: '2'
                        season_id: '21256'
                        season_name: 26/27
                        stage_id: '1'
                        stage_name: Regular Season
                        group_id: '2468'
                        group_name: Kategoria Superiore
                        aggregate_id: null
                        winner_team_id: 4475
                        venue_id: '626'
                        leg: null
                        week: '35'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-08-30 21:00:00'
                          date: '2026-08-30'
                          time: '21:00:00'
                          minute: 90
                          timestamp: 1788123600
                          timezone: UTC+2
                        teams:
                          home:
                            id: 4475
                            name: KF Teuta
                            short_code: TEU
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/4475.png
                            form: null
                            coach_id: '13090'
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#ffffff'
                              home_gk_second_color: '#ffffff'
                              home_gk_number_color: '#0000ff'
                          away:
                            id: 4707
                            name: KF Tirana
                            short_code: KFT
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/4707.png
                            form: null
                            coach_id: '1864'
                            kit_colors:
                              away_main_color: '#585858'
                              away_second_color: '#585858'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#efc131'
                              away_gk_second_color: '#333333'
                              away_gk_number_color: '#000000'
                        league:
                          id: 784
                          name: Kategoria Superiore
                          type: Kategoria Superiore
                          country_id: '8'
                          country_name: Albania
                          country_code: al
                          country_flag: https://cdn.soccersapi.com/images/countries/30/al.png
                        scores:
                          home_score: '3'
                          away_score: '1'
                          ht_score: 0-1
                          ft_score: 3-1
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 6
                          away_position: 10
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 1
                          has_standings: 1
                        weather_report:
                          desc: mainly clear
                          temp:
                            celsius: 27.9
                            fahrenheit: 82.2
                          wind:
                            kmph: 3.9
                            miles: 2.42
                            direction: SE
                          humidity_percent: 81
                          pressure: 1013
                        broadcast:
                          - id: '13951'
                            name: DAZN France
                            type: '1'
                            country:
                              id: '10'
                              name: Andorra
                              cc: ad
                      - id: 2673507
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '223647'
                        round_name: '2'
                        season_id: '21408'
                        season_name: 26/27
                        stage_id: '1'
                        stage_name: Regular Season
                        group_id: '14150'
                        group_name: Girabola 26/27
                        aggregate_id: null
                        winner_team_id: 5844
                        venue_id: '1026'
                        leg: null
                        week: '35'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-08-30 16:30:00'
                          date: '2026-08-30'
                          time: '16:30:00'
                          minute: 90
                          timestamp: 1788107400
                          timezone: UTC+2
                        teams:
                          home:
                            id: 7620
                            name: Petroleos Do Lobito
                            short_code: APL
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/7620.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 5844
                            name: Atletico Petroleos de Luanda
                            short_code: LUA
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/5844.png
                            form: null
                            coach_id: null
                            kit_colors:
                              away_main_color: '#d8f510'
                              away_second_color: '#000000'
                              away_number_color: '#000000'
                              away_gk_main_color: '#efc131'
                              away_gk_second_color: '#333333'
                              away_gk_number_color: '#000000'
                        league:
                          id: 813
                          name: Girabola
                          type: Girabola 26/27
                          country_id: '11'
                          country_name: Angola
                          country_code: ao
                          country_flag: https://cdn.soccersapi.com/images/countries/30/ao.png
                        scores:
                          home_score: '0'
                          away_score: '2'
                          ht_score: '-'
                          ft_score: 0-2
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 14
                          away_position: 4
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 1
                        weather_report:
                          desc: clear/sunny
                          temp:
                            celsius: 23.5
                            fahrenheit: 74.3
                          wind:
                            kmph: 15.3
                            miles: 9.51
                            direction: W
                          humidity_percent: 74
                          pressure: 1014
                        broadcast: null
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 13
                      count: 100
                      total: 1241
                      msg: ''
                season:
                  summary: Fixtures by season
                  value:
                    data: []
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: 0
                      msg: ''
                round:
                  summary: Fixtures by round
                  value:
                    data:
                      - id: 31162
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '1994'
                        round_name: '1'
                        season_id: '406'
                        season_name: 19/20
                        stage_id: '1'
                        stage_name: Regular Season
                        group_id: '222'
                        group_name: Bundesliga
                        aggregate_id: null
                        winner_team_id: '0'
                        venue_id: '1446'
                        leg: null
                        week: '33'
                        deleted: '0'
                        related_id: null
                        info: null
                        attendance: null
                        time:
                          datetime: '2019-08-16 18:30:00'
                          date: '2019-08-16'
                          time: '18:30:00'
                          minute: 90
                          timestamp: 1565980200
                          timezone: UTC
                        teams:
                          home:
                            id: 111
                            name: FC Bayern Munich
                            short_code: BMU
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/111.png
                            form: null
                            coach_id: '5992'
                            kit_colors:
                              home_main_color: '#f23a3a'
                              home_second_color: '#ffffff'
                              home_number_color: '#ffffff'
                              home_gk_main_color: '#69d68d'
                              home_gk_second_color: '#83e79e'
                              home_gk_number_color: '#000000'
                          away:
                            id: 2806
                            name: Hertha BSC
                            short_code: BSC
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/2806.png
                            form: null
                            coach_id: '256'
                            kit_colors:
                              away_main_color: '#f4f6fa'
                              away_second_color: '#001fb8'
                              away_number_color: '#0e59ca'
                              away_gk_main_color: '#43beec'
                              away_gk_second_color: '#7366c0'
                              away_gk_number_color: '#f1efef'
                        league:
                          id: 594
                          name: Bundesliga
                          type: Bundesliga
                          country_id: '4'
                          country_name: Germany
                          country_code: de
                          country_flag: https://cdn.soccersapi.com/images/countries/30/de.png
                        scores:
                          home_score: '2'
                          away_score: '2'
                          ht_score: 1-2
                          ft_score: 2-2
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 0
                          away_position: 0
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 1
                        weather_report:
                          desc: clear/sunny
                          temp:
                            celsius: 22
                            fahrenheit: 71.6
                          wind:
                            kmph: null
                            miles: 0
                            direction: SW
                          humidity_percent: 54
                          pressure: 1014
                      - id: 31163
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '1994'
                        round_name: '1'
                        season_id: '406'
                        season_name: 19/20
                        stage_id: '1'
                        stage_name: Regular Season
                        group_id: '222'
                        group_name: Bundesliga
                        aggregate_id: null
                        winner_team_id: '114'
                        venue_id: '1386'
                        leg: null
                        week: '33'
                        deleted: '0'
                        related_id: null
                        info: null
                        attendance: null
                        time:
                          datetime: '2019-08-17 13:30:00'
                          date: '2019-08-17'
                          time: '13:30:00'
                          minute: 90
                          timestamp: 1566048600
                          timezone: UTC
                        teams:
                          home:
                            id: 114
                            name: Bayer 04 Leverkusen
                            short_code: LEV
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/114.png
                            form: null
                            coach_id: '5242'
                            kit_colors:
                              home_main_color: '#3b373c'
                              home_second_color: '#39393f'
                              home_number_color: '#ffffff'
                              home_gk_main_color: '#f5903a'
                              home_gk_second_color: '#f5903a'
                              home_gk_number_color: '#f5f9fa'
                          away:
                            id: 2807
                            name: SC Paderborn 07
                            short_code: PAD
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/2807.png
                            form: null
                            coach_id: '3225'
                            kit_colors:
                              away_main_color: '#ffffff'
                              away_second_color: '#308ad1'
                              away_number_color: '#000000'
                              away_gk_main_color: '#f52c4e'
                              away_gk_second_color: '#f62a53'
                              away_gk_number_color: '#0d3d82'
                        league:
                          id: 594
                          name: Bundesliga
                          type: Bundesliga
                          country_id: '4'
                          country_name: Germany
                          country_code: de
                          country_flag: https://cdn.soccersapi.com/images/countries/30/de.png
                        scores:
                          home_score: '3'
                          away_score: '2'
                          ht_score: 2-2
                          ft_score: 3-2
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 0
                          away_position: 0
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 0
                          has_standings: 1
                        weather_report:
                          desc: partly cloudy
                          temp:
                            celsius: 20
                            fahrenheit: 68
                          wind:
                            kmph: 20
                            miles: 12.4
                            direction: SSW
                          humidity_percent: 71
                          pressure: 1008
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 9
                      total: 9
                      msg: ''
                last_next:
                  summary: Team last and next fixtures
                  value:
                    data:
                      next:
                        - id: 2632679
                          status: '0'
                          status_name: Notstarted
                          status_period: null
                          pitch: null
                          referee_id: null
                          round_id: '220259'
                          round_name: '4'
                          season_id: '21233'
                          season_name: 26/27
                          stage_id: '1'
                          stage_name: Regular Season
                          group_id: '207'
                          group_name: LaLiga
                          aggregate_id: null
                          winner_team_id: null
                          venue_id: '737'
                          leg: null
                          week: '36'
                          deleted: '0'
                          related_id: null
                          info: null
                          attendance: null
                          time:
                            datetime: '2026-09-06 14:15:00'
                            date: '2026-09-06'
                            time: '14:15:00'
                            minute: ''
                            timestamp: 1788704100
                            timezone: UTC
                          teams:
                            home:
                              id: 103
                              name: CF Valencia
                              short_code: VCF
                              img: https://cdn.soccersapi.com/images/soccer/teams/80/103.png
                              form: null
                              coach_id: '6041'
                              kit_colors:
                                home_main_color: '#ffffff'
                                home_second_color: '#ffffff'
                                home_number_color: '#040404'
                                home_gk_main_color: '#fa96c2'
                                home_gk_second_color: '#f5f5ed'
                                home_gk_number_color: '#000000'
                            away:
                              id: 99
                              name: FC Barcelona
                              short_code: BAR
                              img: https://cdn.soccersapi.com/images/soccer/teams/80/99.png
                              form: null
                              coach_id: '662'
                              kit_colors:
                                away_main_color: '#e2cfa5'
                                away_second_color: '#120fa3'
                                away_number_color: '#000000'
                                away_gk_main_color: '#e46c3b'
                                away_gk_second_color: '#d58e50'
                                away_gk_number_color: '#050505'
                          league:
                            id: 637
                            name: LaLiga
                            type: LaLiga
                            country_id: '5'
                            country_name: Spain
                            country_code: es
                            country_flag: https://cdn.soccersapi.com/images/countries/30/es.png
                          scores:
                            home_score: null
                            away_score: null
                            ht_score: '-'
                            ft_score: '-'
                            et_score: null
                            ps_score: null
                          standings:
                            home_position: 17
                            away_position: 1
                          assistants:
                            first_assistant_id: null
                            second_assistant_id: null
                            fourth_assistant_id: null
                          coverage:
                            has_lineups: 0
                            has_tvs: 1
                            has_standings: 1
                          weather_report: null
                      current: []
                      last:
                        - id: 2632670
                          status: '3'
                          status_name: Finished
                          status_period: null
                          pitch: null
                          referee_id: null
                          round_id: '220258'
                          round_name: '3'
                          season_id: '21233'
                          season_name: 26/27
                          stage_id: '1'
                          stage_name: Regular Season
                          group_id: '207'
                          group_name: LaLiga
                          aggregate_id: null
                          winner_team_id: '99'
                          venue_id: '86'
                          leg: null
                          week: '36'
                          deleted: '0'
                          related_id: null
                          info: null
                          attendance: null
                          time:
                            datetime: '2026-08-31 19:30:00'
                            date: '2026-08-31'
                            time: '19:30:00'
                            minute: 90
                            timestamp: 1788204600
                            timezone: UTC
                          teams:
                            home:
                              id: 99
                              name: FC Barcelona
                              short_code: BAR
                              img: https://cdn.soccersapi.com/images/soccer/teams/80/99.png
                              form: null
                              coach_id: '662'
                              kit_colors:
                                home_main_color: '#282e60'
                                home_second_color: '#0d0d0d'
                                home_number_color: '#efc006'
                                home_gk_main_color: '#e46c3b'
                                home_gk_second_color: '#d58e50'
                                home_gk_number_color: '#050505'
                            away:
                              id: 2403
                              name: Rayo Vallecano
                              short_code: RVC
                              img: https://cdn.soccersapi.com/images/soccer/teams/80/2403.png
                              form: null
                              coach_id: '10642'
                              kit_colors:
                                away_main_color: '#ffffff'
                                away_second_color: '#e33641'
                                away_number_color: '#d6b142'
                                away_gk_main_color: '#262726'
                                away_gk_second_color: '#418e4a'
                                away_gk_number_color: '#fafafa'
                          league:
                            id: 637
                            name: LaLiga
                            type: LaLiga
                            country_id: '5'
                            country_name: Spain
                            country_code: es
                            country_flag: https://cdn.soccersapi.com/images/countries/30/es.png
                          scores:
                            home_score: '5'
                            away_score: '2'
                            ht_score: 2-1
                            ft_score: 5-2
                            et_score: null
                            ps_score: null
                          standings:
                            home_position: 4
                            away_position: 16
                          assistants:
                            first_assistant_id: null
                            second_assistant_id: null
                            fourth_assistant_id: null
                          coverage:
                            has_lineups: 1
                            has_tvs: 1
                            has_standings: 1
                          weather_report:
                            desc: partly cloudy
                            temp:
                              celsius: 25.6
                              fahrenheit: 78.1
                            wind:
                              kmph: 7.4
                              miles: 4.6
                              direction: SSE
                            humidity_percent: 74
                            pressure: 1019
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 50
                      total: 50
                      msg: ''
                tv:
                  summary: Fixtures by TV channel
                  value:
                    data:
                      - id: 2628127
                        status: '0'
                        status_name: Notstarted
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '219790'
                        round_name: '4'
                        season_id: '21208'
                        season_name: 26/27
                        stage_id: '1'
                        stage_name: Regular Season
                        group_id: '13796'
                        group_name: Super Lig 26/27
                        aggregate_id: null
                        winner_team_id: null
                        venue_id: '798'
                        leg: null
                        week: '36'
                        deleted: '0'
                        related_id: null
                        info: null
                        attendance: null
                        time:
                          datetime: '2026-09-04 17:00:00'
                          date: '2026-09-04'
                          time: '17:00:00'
                          minute: ''
                          timestamp: 1788541200
                          timezone: UTC
                        teams:
                          home:
                            id: 90
                            name: Basaksehir FK
                            short_code: BAS
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/90.png
                            form: null
                            coach_id: '7559'
                            kit_colors:
                              home_main_color: '#f26522'
                              home_second_color: '#14235e'
                              home_number_color: '#122056'
                              home_gk_main_color: '#d4f588'
                              home_gk_second_color: '#d4f588'
                              home_gk_number_color: '#000000'
                          away:
                            id: 106
                            name: Galatasaray
                            short_code: GAL
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/106.png
                            form: null
                            coach_id: '707'
                            kit_colors:
                              away_main_color: '#ffffff'
                              away_second_color: '#f27050'
                              away_number_color: '#a02727'
                              away_gk_main_color: '#0c5c33'
                              away_gk_second_color: '#0d663c'
                              away_gk_number_color: '#f8fcfb'
                        league:
                          id: 3515
                          name: Super Lig
                          type: Super Lig 26/27
                          country_id: '118'
                          country_name: Turkey
                          country_code: tr
                          country_flag: https://cdn.soccersapi.com/images/countries/30/tr.png
                        scores:
                          home_score: null
                          away_score: null
                          ht_score: '-'
                          ft_score: '-'
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 9
                          away_position: 1
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 1
                          has_standings: 1
                        weather_report:
                          desc: mainly clear
                          temp:
                            celsius: 22.1
                            fahrenheit: 71.8
                          wind:
                            kmph: 13.3
                            miles: 8.26
                            direction: NE
                          humidity_percent: 76
                          pressure: 1016
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                info:
                  summary: Match by ID
                  value:
                    data:
                      id: 2589310
                      status: 3
                      status_name: Finished
                      status_period: null
                      pitch: null
                      referee_id: null
                      round_id: '216028'
                      round_name: '2'
                      season_id: '21033'
                      season_name: 26/27
                      stage_id: '3461'
                      stage_name: Regular Season - Premier League 26/27
                      group_id: '13583'
                      group_name: Premier League 26/27
                      aggregate_id: null
                      winner_team_id: 20
                      venue_id: '1166'
                      leg: null
                      week: '35'
                      deleted: '0'
                      related_id: null
                      info: null
                      attendance: null
                      time:
                        datetime: '2026-08-30 13:00:00'
                        date: '2026-08-30'
                        time: '13:00:00'
                        minute: 90
                        timestamp: 1788094800
                        timezone: UTC
                      teams:
                        home:
                          id: 20
                          name: Chelsea FC
                          short_code: CFC
                          img: https://cdn.soccersapi.com/images/soccer/teams/80/20.png
                          form: null
                          coach_id: 12680
                          kit_colors:
                            home_main_color: '#1532c1'
                            home_second_color: '#1532c1'
                            home_number_color: '#f7d444'
                            home_gk_main_color: '#1d5160'
                            home_gk_second_color: '#121212'
                            home_gk_number_color: '#fcfcfc'
                        away:
                          id: 12
                          name: Brighton & Hove Albion
                          short_code: BRI
                          img: https://cdn.soccersapi.com/images/soccer/teams/80/12.png
                          form: null
                          coach_id: 9291
                          kit_colors:
                            away_main_color: '#ffffff'
                            away_second_color: '#ffffff'
                            away_number_color: '#306fbe'
                            away_gk_main_color: '#fff200'
                            away_gk_second_color: '#ffe900'
                            away_gk_number_color: '#faf4f4'
                      league:
                        id: 583
                        name: Premier League
                        type: Premier League 26/27
                        country_id: '3'
                        country_name: England
                        country_code: en
                        country_flag: https://cdn.soccersapi.com/images/countries/30/en.png
                      scores:
                        home_score: '4'
                        away_score: '3'
                        ht_score: 3-1
                        ft_score: 4-3
                        et_score: null
                        ps_score: null
                      standings:
                        home_position: 8
                        away_position: 5
                      assistants:
                        first_assistant_id: null
                        second_assistant_id: null
                        fourth_assistant_id: null
                      coverage:
                        has_lineups: 1
                        has_tvs: 1
                        has_standings: 1
                      weather_report:
                        desc: cloudy
                        temp:
                          celsius: 21.2
                          fahrenheit: 70.2
                        wind:
                          kmph: 13.7
                          miles: 8.51
                          direction: SW
                        humidity_percent: 56
                        pressure: 1009
                      events:
                        - team_id: 20
                          type: corner
                          period: 1st half
                          player_id: null
                          player_name: null
                          related_player_id: null
                          related_player_name: null
                          minute: '4'
                          extra_minute: null
                          timestamp: null
                          reason: null
                          injuried: null
                          own_goal: false
                          penalty: false
                          result: null
                          info: 1st Corner kick
                      stats:
                        - team_id: 20
                          key_passes: '14'
                          passing_accuracy: 67
                          fouls: '5'
                          injuries: '2'
                          corners: '4'
                          crosses: '5'
                          crossing_accuracy: 40
                          offsides: '0'
                          shots_total: 22
                          shots_on_target: '6'
                          shots_off_target: '11'
                          shots_blocked: '5'
                          possessiontime: 23.4
                          possessionpercent: 26
                          yellowcards: '1'
                          yellowredcards: '0'
                          redcards: '0'
                          substitutions: '5'
                          goal_kick: '16'
                          goal_attempts: '10'
                          free_kick: '14'
                          throw_in: '13'
                          ball_safe: '76'
                          goals: 4
                          penalties: '0'
                          attacks: '58'
                          dangerous_attacks: '23'
                          action_areas: '29.00'
                          xg: '2.96'
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                sort:
                  summary: Matches by multiple IDs
                  value:
                    data:
                      - id: 2589310
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '216028'
                        round_name: '2'
                        season_id: '21033'
                        season_name: 26/27
                        stage_id: '3461'
                        stage_name: Regular Season - Premier League 26/27
                        group_id: '13583'
                        group_name: Premier League 26/27
                        aggregate_id: null
                        winner_team_id: '20'
                        venue_id: '1166'
                        leg: null
                        week: '35'
                        deleted: '0'
                        related_id: null
                        info: null
                        attendance: null
                        time:
                          datetime: '2026-08-30 13:00:00'
                          date: '2026-08-30'
                          time: '13:00:00'
                          minute: 90
                          timestamp: 1788094800
                          timezone: UTC
                        teams:
                          home:
                            id: 20
                            name: Chelsea FC
                            short_code: CFC
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/20.png
                            form: null
                            coach_id: '12680'
                            kit_colors:
                              home_main_color: '#1532c1'
                              home_second_color: '#1532c1'
                              home_number_color: '#f7d444'
                              home_gk_main_color: '#1d5160'
                              home_gk_second_color: '#121212'
                              home_gk_number_color: '#fcfcfc'
                          away:
                            id: 12
                            name: Brighton & Hove Albion
                            short_code: BRI
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/12.png
                            form: null
                            coach_id: '9291'
                            kit_colors:
                              away_main_color: '#ffffff'
                              away_second_color: '#ffffff'
                              away_number_color: '#306fbe'
                              away_gk_main_color: '#fff200'
                              away_gk_second_color: '#ffe900'
                              away_gk_number_color: '#faf4f4'
                        league:
                          id: 583
                          name: Premier League
                          type: Premier League 26/27
                          country_id: '3'
                          country_name: England
                          country_code: en
                          country_flag: https://cdn.soccersapi.com/images/countries/30/en.png
                        scores:
                          home_score: '4'
                          away_score: '3'
                          ht_score: 3-1
                          ft_score: 4-3
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 8
                          away_position: 5
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 1
                          has_tvs: 1
                          has_standings: 1
                        weather_report:
                          desc: cloudy
                          temp:
                            celsius: 21.2
                            fahrenheit: 70.2
                          wind:
                            kmph: 13.7
                            miles: 8.51
                            direction: SW
                          humidity_percent: 56
                          pressure: 1009
                        events:
                          - team_id: 20
                            type: corner
                            period: 1st half
                            player_id: null
                            player_name: null
                            related_player_id: null
                            related_player_name: null
                            minute: '4'
                            extra_minute: null
                            timestamp: null
                            reason: null
                            injuried: null
                            own_goal: false
                            penalty: false
                            result: null
                            info: 1st Corner kick
                      - id: 2589313
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '216028'
                        round_name: '2'
                        season_id: '21033'
                        season_name: 26/27
                        stage_id: '3461'
                        stage_name: Regular Season - Premier League 26/27
                        group_id: '13583'
                        group_name: Premier League 26/27
                        aggregate_id: null
                        winner_team_id: '0'
                        venue_id: '107'
                        leg: null
                        week: '35'
                        deleted: '0'
                        related_id: null
                        info: null
                        attendance: null
                        time:
                          datetime: '2026-08-30 13:00:00'
                          date: '2026-08-30'
                          time: '13:00:00'
                          minute: 90
                          timestamp: 1788094800
                          timezone: UTC
                        teams:
                          home:
                            id: 274
                            name: Leeds United
                            short_code: LEE
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/274.png
                            form: null
                            coach_id: '43'
                            kit_colors:
                              home_main_color: '#fdf9f9'
                              home_second_color: '#21267e'
                              home_number_color: '#17277f'
                              home_gk_main_color: '#8ed797'
                              home_gk_second_color: '#94d698'
                              home_gk_number_color: '#0d3423'
                          away:
                            id: 265
                            name: Brentford FC
                            short_code: BRE
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/265.png
                            form: null
                            coach_id: '12299'
                            kit_colors:
                              away_main_color: '#282335'
                              away_second_color: '#e5d9ca'
                              away_number_color: '#fafaf9'
                              away_gk_main_color: '#c597c6'
                              away_gk_second_color: '#242841'
                              away_gk_number_color: '#080808'
                        league:
                          id: 583
                          name: Premier League
                          type: Premier League 26/27
                          country_id: '3'
                          country_name: England
                          country_code: en
                          country_flag: https://cdn.soccersapi.com/images/countries/30/en.png
                        scores:
                          home_score: '1'
                          away_score: '1'
                          ht_score: 0-1
                          ft_score: 1-1
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 10
                          away_position: 6
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 1
                          has_tvs: 1
                          has_standings: 1
                        weather_report:
                          desc: cloudy
                          temp:
                            celsius: 20.7
                            fahrenheit: 69.3
                          wind:
                            kmph: 11.9
                            miles: 7.39
                            direction: SW
                          humidity_percent: 56
                          pressure: 1006
                        events:
                          - team_id: 265
                            type: shot_off_target
                            period: 1st half
                            player_id: 20877
                            player_name: Schade
                            related_player_id: null
                            related_player_name: null
                            minute: '1'
                            extra_minute: null
                            timestamp: null
                            reason: null
                            injuried: null
                            own_goal: false
                            penalty: false
                            result: null
                            info: 1st Shot Off Target
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 2
                      total: 2
                      msg: ''
                match_events:
                  summary: Match events
                  value:
                    data:
                      - team_id: '20'
                        type: corner
                        period: 1st half
                        player_id: null
                        player_name: null
                        related_player_id: null
                        related_player_name: null
                        minute: '4'
                        extra_minute: null
                        timestamp: null
                        reason: null
                        injuried: null
                        own_goal: false
                        penalty: false
                        result: null
                        info: 1st Corner kick
                      - team_id: '20'
                        type: goal
                        period: 1st half
                        player_id: '603175450'
                        player_name: Lavia
                        related_player_id: null
                        related_player_name: null
                        minute: '4'
                        extra_minute: null
                        timestamp: null
                        reason: null
                        injuried: null
                        own_goal: false
                        penalty: false
                        result: null
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 62
                      total: 62
                      msg: ''
                match_lineups:
                  summary: Match lineups
                  value:
                    data:
                      home:
                        formation: 3-4-2-1
                        confirmed_formation: 1
                        squad:
                          - player:
                              id: '323'
                              name: Martinez, Emilano
                              common_name: Martinez, Emilano
                              firstname: Damian Emiliano
                              lastname: Martinez
                              weight: '89'
                              height: '195'
                              img: https://cdn.soccersapi.com/images/soccer/players/50/323.png
                              country:
                                id: '12'
                                name: Argentina
                                cc: ar
                            number: '26'
                            captain: null
                            position: G
                            position_name: null
                            order: 1
                      away:
                        formation: 4-2-3-1
                        confirmed_formation: 1
                        squad:
                          - player:
                              id: '5393'
                              name: Verbruggen, Bart
                              common_name: Verbruggen, Bart
                              firstname: Bart
                              lastname: Verbruggen
                              weight: '87'
                              height: '193'
                              img: https://cdn.soccersapi.com/images/soccer/players/50/5393.png
                              country:
                                id: '81'
                                name: Netherlands
                                cc: nl
                            number: '1'
                            captain: null
                            position: G
                            position_name: null
                            order: 1
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                match_bench:
                  summary: Match bench
                  value:
                    data:
                      home:
                        - player:
                            id: '739875829'
                            name: Penders, Mike
                            common_name: Penders, Mike
                            firstname: Mike
                            lastname: Penders
                            weight: '93'
                            height: '200'
                            img: https://cdn.soccersapi.com/images/soccer/players/50/739875829.png
                            country:
                              id: null
                              name: null
                              cc: null
                          number: '39'
                          captain: null
                          position: G
                          position_name: null
                          order: 1
                      away:
                        - player:
                            id: '22683'
                            name: Steele, Jason
                            common_name: Steele, Jason
                            firstname: Jason
                            lastname: Steele
                            weight: '79'
                            height: '188'
                            img: https://cdn.soccersapi.com/images/soccer/players/50/22683.png
                            country:
                              id: '3'
                              name: England
                              cc: en
                          number: '23'
                          captain: null
                          position: G
                          position_name: null
                          order: 1
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                match_comments:
                  summary: Match commentary
                  value:
                    data:
                      - important: 0
                        order: 1
                        goal: 0
                        minute: 0
                        extra_minute: null
                        comment: 'We are live: Chelsea against Brighton.'
                      - important: 0
                        order: 3
                        goal: 0
                        minute: 0
                        extra_minute: null
                        comment: The match is being played at Stamford Bridge.
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 65
                      total: 65
                      msg: ''
                match_sidelined:
                  summary: Match sidelined players
                  value:
                    data:
                      home:
                        id: 20
                        name: Chelsea FC
                        types:
                          injuries: []
                          suspension: []
                      away:
                        id: 12
                        name: Brighton & Hove Albion
                        types:
                          injuries: []
                          suspension: []
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 0
                      total: null
                      msg: ''
                match_odds:
                  summary: Pre-match odds
                  value:
                    data:
                      - id: 1
                        name: 1X2, Full Time Result
                        bookmakers:
                          - id: 2
                            name: bet365
                            odds:
                              data:
                                home: '1.850'
                                draw: '3.600'
                                away: '3.800'
                                handicap: null
                                score: null
                                minute: null
                                bookmaker_event_id: null
                                last_update:
                                  date: 2026-08-22 18:24
                                  timezone: UTC
                      - id: 2
                        name: Over/Under, Goal Line
                        bookmakers:
                          - id: 2
                            name: bet365
                            odds:
                              data:
                                - over: '1.975'
                                  under: '1.875'
                                  handicap: 2.5,3.0
                                  score: null
                                  minute: null
                                  bookmaker_event_id: null
                                  last_update:
                                    date: 2026-08-22 19:30
                                    timezone: UTC
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 3
                      total: 3
                      msg: ''
                match_oddsinplay:
                  summary: In-play odds
                  value:
                    data:
                      - id: 1
                        name: 1X2, Full Time Result
                        bookmakers:
                          - id: 2
                            name: bet365
                            odds:
                              data:
                                home: '1.004'
                                draw: '41.000'
                                away: '351.000'
                                handicap: null
                                score: 4-2
                                minute: '90'
                                bookmaker_event_id: null
                                last_update:
                                  date: 2026-08-30 14:49
                                  timezone: UTC
                      - id: 2
                        name: Over/Under, Goal Line
                        bookmakers:
                          - id: 2
                            name: bet365
                            odds:
                              data:
                                - over: '7.000'
                                  under: '1.110'
                                  handicap: '6.5'
                                  score: 4-2
                                  minute: '93'
                                  bookmaker_event_id: null
                                  last_update:
                                    date: 2026-08-30 14:52
                                    timezone: UTC
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 3
                      total: 3
                      msg: ''
                match_odds_info:
                  summary: Match odds by bookmaker
                  value:
                    data:
                      id: '1'
                      name: 10Bet
                      markets:
                        - id: 1
                          name: 1X2, Full Time Result
                          odds:
                            - home: '13.000'
                              draw: '1.090'
                              away: '8.000'
                              handicap: null
                              score: null
                              minute: null
                              bookmaker_event_id: null
                              last_update:
                                date: 2026-08-30 13:04
                                timezone: UTC
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/stats/:
    get:
      summary: Statistics
      operationId: getStatistics
      tags:
        - Statistics
      description: |
        Aggregated statistics for leagues, seasons, teams and players, and per-match statistics. The meaning of `id` depends on the operation.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `league` | League statistics, current season. Season totals of the current season of a league: matches, goals, cards, clean sheets, goal ranges and goal lines. | `id` | — |
        | `season` | League statistics by season. Season totals such as goals, cards and goal lines. | `id` | — |
        | `team` | Team statistics by season. Goals scored and conceded, clean sheets, cards and goal ranges of a team in a season. | `id`, `season_id` | — |
        | `player` | Player statistics. Season statistics with `id` and `season_id`, or single-match statistics with `player_id` and `match_id`. | — | `id`, `season_id`, `player_id`, `match_id`, `lang` |
        | `match` | Match statistics. Team statistics of one match, one entry per team. | `id` | — |

        ## Examples

        League statistics, current season:

        ```http
        GET /v2.2/stats/?user=USER&token=TOKEN&t=league&id=1005
        ```

        League statistics by season:

        ```http
        GET /v2.2/stats/?user=USER&token=TOKEN&t=season&id=12588
        ```

        Team statistics by season:

        ```http
        GET /v2.2/stats/?user=USER&token=TOKEN&t=team&id=98&season_id=406
        ```

        Player statistics:

        ```http
        GET /v2.2/stats/?user=USER&token=TOKEN&t=player&id=18103&season_id=12516
        ```

        Match statistics:

        ```http
        GET /v2.2/stats/?user=USER&token=TOKEN&t=match&id=2589310
        ```
      x-operations:
        - t: league
          title: League statistics, current season
          purpose: 'Season totals of the current season of a league: matches, goals, cards, clean sheets, goal ranges and goal lines.'
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=1005
        - t: season
          title: League statistics by season
          purpose: Season totals such as goals, cards and goal lines.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=12588
        - t: team
          title: Team statistics by season
          purpose: Goals scored and conceded, clean sheets, cards and goal ranges of a team in a season.
          required:
            - id
            - season_id
          optional: []
          schema: DataResponse
          example: id=98&season_id=406
        - t: player
          title: Player statistics
          purpose: Season statistics with `id` and `season_id`, or single-match statistics with `player_id` and `match_id`.
          required: []
          optional:
            - id
            - season_id
            - player_id
            - match_id
            - lang
          schema: DataResponse
          example: id=18103&season_id=12516
        - t: match
          title: Match statistics
          purpose: Team statistics of one match, one entry per team.
          required:
            - id
          optional: []
          schema: MatchStatsResponse
          example: id=2589310
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: league
          schema:
            type: string
            enum:
              - league
              - season
              - team
              - player
              - match
            x-enumDescriptions:
              league: League statistics, current season
              season: League statistics by season
              team: Team statistics by season
              player: Player statistics
              match: Match statistics
        - name: id
          in: query
          required: false
          description: 'Resource ID: league ID for `league`, season ID for `season`, team ID for `team`, player ID for `player`, match ID for `match`. Required when `t` is `league`, `season`, `team`, `match`. Optional for `player`.'
          schema:
            type: string
          example: '1005'
        - name: season_id
          in: query
          required: false
          description: Season ID. Required when `t` is `team`. Optional for `player`.
          schema:
            type: string
          example: '406'
        - name: player_id
          in: query
          required: false
          description: Player ID. Optional for `player`.
          schema:
            type: string
          example: '11306'
        - name: match_id
          in: query
          required: false
          description: Match ID. Optional for `player`.
          schema:
            type: string
          example: '1531916'
        - $ref: '#/components/parameters/Lang'
      responses:
        '200':
          description: |-
            The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.

            - `t=league`: DataResponse
            - `t=season`: DataResponse
            - `t=team`: DataResponse
            - `t=player`: DataResponse
            - `t=match`: MatchStatsResponse
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/DataResponse'
                  - $ref: '#/components/schemas/MatchStatsResponse'
              examples:
                league:
                  summary: League statistics, current season
                  value:
                    data:
                      season_id: 15287
                      league_id: 1005
                      number_of_teams: 12
                      number_of_matches: 132
                      number_of_matches_played: 120
                      team_most_scored:
                        id: '104'
                        total_goals: 42
                      player_most_scored:
                        id: '99689'
                        total_goals: 10
                      substituted_in:
                        total: 370
                        avg_per_match: 3.08
                        avg_every_minutes: 0
                      assists:
                        total: 216
                        avg_per_match: 1.8
                        avg_every_minutes: 0
                      cards:
                        total:
                          total: 512
                          avg_per_match: 4.27
                          avg_every_minutes: 21
                        yellow:
                          total: 484
                          avg_per_match: 4.03
                          avg_every_minutes: 22
                        yellowred:
                          total: 12
                          avg_per_match: 0.1
                          avg_every_minutes: 900
                        red:
                          total: 16
                          avg_per_match: 0.13
                          avg_every_minutes: 675
                      goals:
                        overall:
                          total: 317
                          percentage_total_goals: 100
                          avg_per_match: 2.64
                          avg_every_minutes: 34
                        home:
                          total: 164
                          percentage_total_goals: 51.74
                          avg_per_match: 1.37
                          avg_every_minutes: 66
                        away:
                          total: 153
                          percentage_total_goals: 48.26
                          avg_per_match: 1.28
                          avg_every_minutes: 71
                      clean_sheets:
                        overall:
                          total: 60
                          avg_per_match: 50
                        home:
                          total: 34
                          avg_per_match: 28.33
                        away:
                          total: 26
                          avg_per_match: 21.67
                      goals_scored_range:
                        0-15:
                          total: 44
                          percentage_total_goals: 13.88
                        15-30:
                          total: 50
                          percentage_total_goals: 15.77
                        30-45:
                          total: 62
                          percentage_total_goals: 19.56
                        45-60:
                          total: 40
                          percentage_total_goals: 12.62
                        60-75:
                          total: 52
                          percentage_total_goals: 16.4
                        75-90:
                          total: 69
                          percentage_total_goals: 21.77
                        90-120:
                          total: 0
                          percentage_total_goals: 0
                      goal_line:
                        over:
                          '0.5':
                            total: 114
                            percentage_total_matches: 95
                          '1.5':
                            total: 92
                            percentage_total_matches: 76.67
                          '2.5':
                            total: 62
                            percentage_total_matches: 51.67
                          '3.5':
                            total: 33
                            percentage_total_matches: 27.5
                          '4.5':
                            total: 11
                            percentage_total_matches: 9.17
                          '5.5':
                            total: 4
                            percentage_total_matches: 3.33
                        under:
                          '0.5':
                            total: 6
                            percentage_total_matches: 5
                          '1.5':
                            total: 28
                            percentage_total_matches: 23.33
                          '2.5':
                            total: 58
                            percentage_total_matches: 48.33
                          '3.5':
                            total: 87
                            percentage_total_matches: 72.5
                          '4.5':
                            total: 109
                            percentage_total_matches: 90.83
                          '5.5':
                            total: 116
                            percentage_total_matches: 96.67
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                season:
                  summary: League statistics by season
                  value:
                    data:
                      season_id: 12588
                      league_id: 1005
                      number_of_teams: 12
                      number_of_matches: 0
                      number_of_matches_played: 195
                      team_most_scored:
                        id: '104'
                        total_goals: 67
                      player_most_scored:
                        id: '8274'
                        total_goals: 21
                      substituted_in:
                        total: 922
                        avg_per_match: 4.73
                        avg_every_minutes: 0
                      assists:
                        total: 354
                        avg_per_match: 1.82
                        avg_every_minutes: 0
                      cards:
                        total:
                          total: 786
                          avg_per_match: 4.03
                          avg_every_minutes: 22
                        yellow:
                          total: 744
                          avg_per_match: 3.82
                          avg_every_minutes: 24
                        yellowred:
                          total: 20
                          avg_per_match: 0.1
                          avg_every_minutes: 878
                        red:
                          total: 22
                          avg_per_match: 0.11
                          avg_every_minutes: 798
                      goals:
                        overall:
                          total: 577
                          percentage_total_goals: 100
                          avg_per_match: 3.1
                          avg_every_minutes: 30
                        home:
                          total: 299
                          percentage_total_goals: 51.82
                          avg_per_match: 1.53
                          avg_every_minutes: 59
                        away:
                          total: 278
                          percentage_total_goals: 48.18
                          avg_per_match: 1.43
                          avg_every_minutes: 63
                      clean_sheets:
                        overall:
                          total: 86
                          avg_per_match: 44.1
                        home:
                          total: 46
                          avg_per_match: 23.59
                        away:
                          total: 40
                          avg_per_match: 20.51
                      goals_scored_range:
                        0-15:
                          total: 78
                          percentage_total_goals: 13.52
                        15-30:
                          total: 75
                          percentage_total_goals: 13
                        30-45:
                          total: 97
                          percentage_total_goals: 16.81
                        45-60:
                          total: 97
                          percentage_total_goals: 16.81
                        60-75:
                          total: 90
                          percentage_total_goals: 15.6
                        75-90:
                          total: 140
                          percentage_total_goals: 24.26
                        90-120:
                          total: 1
                          percentage_total_goals: 0.17
                      goal_line:
                        over:
                          '0.5':
                            total: 186
                            percentage_total_matches: 95.38
                          '1.5':
                            total: 159
                            percentage_total_matches: 81.54
                          '2.5':
                            total: 112
                            percentage_total_matches: 57.44
                          '3.5':
                            total: 68
                            percentage_total_matches: 34.87
                          '4.5':
                            total: 35
                            percentage_total_matches: 17.95
                          '5.5':
                            total: 14
                            percentage_total_matches: 7.18
                        under:
                          '0.5':
                            total: 9
                            percentage_total_matches: 4.62
                          '1.5':
                            total: 36
                            percentage_total_matches: 18.46
                          '2.5':
                            total: 83
                            percentage_total_matches: 42.56
                          '3.5':
                            total: 127
                            percentage_total_matches: 65.13
                          '4.5':
                            total: 160
                            percentage_total_matches: 82.05
                          '5.5':
                            total: 181
                            percentage_total_matches: 92.82
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                team:
                  summary: Team statistics by season
                  value:
                    data:
                      id: '98'
                      league_id: '594'
                      season_id: '406'
                      total_matches: 34
                      assists: 36
                      substituted_in: 62
                      penalties: 1
                      goals_scored:
                        overall:
                          total: 84
                          avg_per_match: 2.47
                        home:
                          total: 46
                          avg_per_match: 2.71
                        away:
                          total: 38
                          avg_per_match: 2.24
                      goals_conceded:
                        overall:
                          total: 41
                          avg_per_match: 1.21
                        home:
                          total: 17
                          avg_per_match: 1
                        away:
                          total: 24
                          avg_per_match: 1.41
                      goals_scored_range:
                        0-15:
                          total: null
                        15-30:
                          total: null
                        30-45:
                          total: null
                        45-60:
                          total: null
                        60-75:
                          total: null
                        75-90:
                          total: null
                        90-120:
                          total: null
                      goals_conceded_range:
                        0-15:
                          total: null
                        15-30:
                          total: null
                        30-45:
                          total: null
                        45-60:
                          total: null
                        60-75:
                          total: null
                        75-90:
                          total: null
                        90-120:
                          total: null
                      clean_sheets:
                        overall:
                          total: 15
                          avg: 36.59
                        home:
                          total: 9
                          avg: 52.94
                        away:
                          total: 6
                          avg: 25
                      cards:
                        total: 57
                        yellow:
                          total: 56
                          avg: 98.25
                        yellowred:
                          total: 1
                          avg: 1.75
                        redcards:
                          total: 0
                          avg: 0
                      goal_line:
                        over:
                          '0.5':
                            overall:
                              total: 33
                              avg: 97.06
                            home:
                              total: 17
                              avg: 50
                            away:
                              total: 16
                              avg: 47.06
                          '1.5':
                            overall:
                              total: 28
                              avg: 82.35
                            home:
                              total: 13
                              avg: 38.24
                            away:
                              total: 15
                              avg: 44.12
                          '2.5':
                            overall:
                              total: 24
                              avg: 70.59
                            home:
                              total: 12
                              avg: 35.29
                            away:
                              total: 12
                              avg: 35.29
                          '3.5':
                            overall:
                              total: 20
                              avg: 58.82
                            home:
                              total: 11
                              avg: 32.35
                            away:
                              total: 9
                              avg: 26.47
                          '4.5':
                            overall:
                              total: 9
                              avg: 26.47
                            home:
                              total: 6
                              avg: 17.65
                            away:
                              total: 3
                              avg: 8.82
                          '5.5':
                            overall:
                              total: 7
                              avg: 20.59
                            home:
                              total: 4
                              avg: 11.76
                            away:
                              total: 3
                              avg: 8.82
                        under:
                          '0.5':
                            overall:
                              total: 1
                              avg: 2.94
                            home:
                              total: 0
                              avg: 0
                            away:
                              total: 1
                              avg: 2.94
                          '1.5':
                            overall:
                              total: 6
                              avg: 17.65
                            home:
                              total: 4
                              avg: 11.76
                            away:
                              total: 2
                              avg: 5.88
                          '2.5':
                            overall:
                              total: 10
                              avg: 29.41
                            home:
                              total: 5
                              avg: 14.71
                            away:
                              total: 5
                              avg: 14.71
                          '3.5':
                            overall:
                              total: 14
                              avg: 41.18
                            home:
                              total: 6
                              avg: 17.65
                            away:
                              total: 8
                              avg: 23.53
                          '4.5':
                            overall:
                              total: 25
                              avg: 73.53
                            home:
                              total: 11
                              avg: 32.35
                            away:
                              total: 14
                              avg: 41.18
                          '5.5':
                            overall:
                              total: 27
                              avg: 79.41
                            home:
                              total: 13
                              avg: 32.35
                            away:
                              total: 14
                              avg: 41.18
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                player:
                  summary: Player statistics
                  value:
                    data:
                      id: '18103'
                      name: Magalhaes, Gabriel
                      matches:
                        played:
                          total: 37
                          avg: 97.37
                        starting:
                          total: 37
                          avg: 97.37
                      minutes_played: 3330
                      assists:
                        total: null
                        avg: 0
                      penalties:
                        total: null
                        avg: 0
                      offsides:
                        total: null
                        avg: 0
                      substitutions:
                        in:
                          total: null
                          avg: 0
                        out:
                          total: null
                          avg: 0
                      cards:
                        yellow:
                          total: 0
                          avg: 0
                        yellowred:
                          total: 0
                          avg: 0
                        redcards:
                          total: 0
                          avg: 0
                      goals:
                        total: 0
                        avg: 0
                      shots:
                        total: 0
                        on_target:
                          total: 0
                          avg: 0
                        off_target:
                          total: 0
                          avg: 0
                        blocked:
                          total: 0
                          avg: 0
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                match:
                  summary: Match statistics
                  value:
                    data:
                      - team_id: 20
                        passes:
                          total: 14
                          accurate: 0.67
                          percentage: 67
                        fouls: 5
                        injuries: 2
                        corners: 4
                        offsides: 0
                        shots_total: 22
                        shots_on_target: 6
                        shots_off_target: 11
                        shots_blocked: 5
                        possessiontime: null
                        possessionpercent: 26
                        yellowcards: 1
                        yellowredcards: 0
                        redcards: 0
                        substitutions: 5
                        goal_kick: 16
                        goal_attempts: 10
                        free_kick: 14
                        throw_in: 13
                        ball_safe: 76
                        goals: 4
                        penalties: 0
                        attacks: 58
                        dangerous_attacks: 23
                      - team_id: 12
                        passes:
                          total: 8
                          accurate: 0.88
                          percentage: 88
                        fouls: 11
                        injuries: 0
                        corners: 7
                        offsides: 0
                        shots_total: 16
                        shots_on_target: 6
                        shots_off_target: 9
                        shots_blocked: 1
                        possessiontime: null
                        possessionpercent: 74
                        yellowcards: 3
                        yellowredcards: 0
                        redcards: 0
                        substitutions: 3
                        goal_kick: 8
                        goal_attempts: 13
                        free_kick: 7
                        throw_in: 25
                        ball_safe: 83
                        goals: 3
                        penalties: 0
                        attacks: 117
                        dangerous_attacks: 70
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 2
                      total: 2
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/h2h/:
    get:
      summary: Head to head
      operationId: getHeadToHead
      tags:
        - Head to head
      description: |
        Historical meetings between two teams.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `teams` | Team vs team. Previous meetings of two teams with the result and form of each one. | `team1`, `team2` | — |
        | `match` | Match head to head. Previous meetings of the two teams of a match. | `id` | — |

        ## Examples

        Team vs team:

        ```http
        GET /v2.2/h2h/?user=USER&token=TOKEN&t=teams&team1=99&team2=113
        ```

        Match head to head:

        ```http
        GET /v2.2/h2h/?user=USER&token=TOKEN&t=match&id=2589310
        ```
      x-operations:
        - t: teams
          title: Team vs team
          purpose: Previous meetings of two teams with the result and form of each one.
          required:
            - team1
            - team2
          optional: []
          schema: DataResponse
          example: team1=99&team2=113
        - t: match
          title: Match head to head
          purpose: Previous meetings of the two teams of a match.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=2589310
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: teams
          schema:
            type: string
            enum:
              - teams
              - match
            x-enumDescriptions:
              teams: Team vs team
              match: Match head to head
        - name: team1
          in: query
          required: false
          description: First team ID. Required when `t` is `teams`.
          schema:
            type: string
          example: '99'
        - name: team2
          in: query
          required: false
          description: Second team ID. Required when `t` is `teams`.
          schema:
            type: string
          example: '113'
        - name: id
          in: query
          required: false
          description: Match ID. Required when `t` is `match`.
          schema:
            type: string
          example: '2589310'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                teams:
                  summary: Team vs team
                  value:
                    data:
                      home:
                        id: 99
                        name: FC Barcelona
                        img: https://cdn.soccersapi.com/images/soccer/teams/100/99.png
                        events:
                          overall:
                            - id: 2632670
                              startdate: '2026-08-31 19:30:00'
                              league:
                                id: 637
                                name: LaLiga
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/637.png
                                country:
                                  id: 5
                                  name: Spain
                                  cc: es
                              teams:
                                home:
                                  id: 99
                                  name: FC Barcelona
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/99.png
                                away:
                                  id: 2403
                                  name: Rayo Vallecano
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/2403.png
                              scores:
                                home_score: '5'
                                away_score: '2'
                                ht_score: 2-1
                                ft_score: 5-2
                                et_score: null
                                ps_score: ''
                              ft_score: 5-2
                              form: W
                          home:
                            - id: 2632670
                              startdate: '2026-08-31 19:30:00'
                              league:
                                id: 637
                                name: LaLiga
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/637.png
                                country:
                                  id: 5
                                  name: Spain
                                  cc: es
                              teams:
                                home:
                                  id: 99
                                  name: FC Barcelona
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/99.png
                                away:
                                  id: 2403
                                  name: Rayo Vallecano
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/2403.png
                              scores:
                                home_score: '5'
                                away_score: '2'
                                ht_score: 2-1
                                ft_score: 5-2
                                et_score: null
                                ps_score: ''
                              ft_score: 5-2
                              form: W
                          away:
                            - id: 2632655
                              startdate: '2026-08-23 19:30:00'
                              league:
                                id: 637
                                name: LaLiga
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/637.png
                                country:
                                  id: 5
                                  name: Spain
                                  cc: es
                              teams:
                                home:
                                  id: 2411
                                  name: Elche CF
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/2411.png
                                away:
                                  id: 99
                                  name: FC Barcelona
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/99.png
                              scores:
                                home_score: '0'
                                away_score: '5'
                                ht_score: 0-2
                                ft_score: 0-5
                                et_score: null
                                ps_score: ''
                              ft_score: 0-5
                              form: W
                      away:
                        id: 113
                        name: Real Madrid
                        img: https://cdn.soccersapi.com/images/soccer/teams/100/113.png
                        events:
                          overall:
                            - id: 2632666
                              startdate: '2026-08-30 15:00:00'
                              league:
                                id: 637
                                name: LaLiga
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/637.png
                                country:
                                  id: 5
                                  name: Spain
                                  cc: es
                              teams:
                                home:
                                  id: 113
                                  name: Real Madrid
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/113.png
                                away:
                                  id: 2409
                                  name: Malaga CF
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/2409.png
                              scores:
                                home_score: '4'
                                away_score: '0'
                                ht_score: 3-0
                                ft_score: 4-0
                                et_score: null
                                ps_score: ''
                              ft_score: 4-0
                              form: W
                          home:
                            - id: 2632666
                              startdate: '2026-08-30 15:00:00'
                              league:
                                id: 637
                                name: LaLiga
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/637.png
                                country:
                                  id: 5
                                  name: Spain
                                  cc: es
                              teams:
                                home:
                                  id: 113
                                  name: Real Madrid
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/113.png
                                away:
                                  id: 2409
                                  name: Malaga CF
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/2409.png
                              scores:
                                home_score: '4'
                                away_score: '0'
                                ht_score: 3-0
                                ft_score: 4-0
                                et_score: null
                                ps_score: ''
                              ft_score: 4-0
                              form: W
                          away:
                            - id: 2632652
                              startdate: '2026-08-22 19:30:00'
                              league:
                                id: 637
                                name: LaLiga
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/637.png
                                country:
                                  id: 5
                                  name: Spain
                                  cc: es
                              teams:
                                home:
                                  id: 127
                                  name: RCD Espanyol Barcelona
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/127.png
                                away:
                                  id: 113
                                  name: Real Madrid
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/113.png
                              scores:
                                home_score: '1'
                                away_score: '2'
                                ht_score: 1-1
                                ft_score: 1-2
                                et_score: null
                                ps_score: ''
                              ft_score: 1-2
                              form: W
                      h2h:
                        - id: 2429729
                          startdate: '2026-05-10 19:00:00'
                          league:
                            id: 637
                            name: LaLiga
                            img: https://cdn.soccersapi.com/images/soccer/leagues/100/637.png
                            country:
                              id: 5
                              name: Spain
                              cc: es
                          teams:
                            home:
                              id: 99
                              name: FC Barcelona
                              img: https://cdn.soccersapi.com/images/soccer/teams/100/99.png
                            away:
                              id: 113
                              name: Real Madrid
                              img: https://cdn.soccersapi.com/images/soccer/teams/100/113.png
                          scores:
                            home_score: '2'
                            away_score: '0'
                            ht_score: 2-0
                            ft_score: 2-0
                            et_score: ''
                            ps_score: ''
                          ft_score: 2-0
                          form: W
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                match:
                  summary: Match head to head
                  value:
                    data:
                      home:
                        id: 20
                        name: Chelsea FC
                        img: https://cdn.soccersapi.com/images/soccer/teams/100/20.png
                        events:
                          overall:
                            - id: 2589310
                              startdate: '2026-08-30 13:00:00'
                              league:
                                id: 583
                                name: Premier League
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/583.png
                                country:
                                  id: 3
                                  name: England
                                  cc: en
                              teams:
                                home:
                                  id: 20
                                  name: Chelsea FC
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/20.png
                                away:
                                  id: 12
                                  name: Brighton & Hove Albion
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/12.png
                              scores:
                                home_score: '4'
                                away_score: '3'
                                ht_score: 3-1
                                ft_score: 4-3
                                et_score: null
                                ps_score: ''
                              ft_score: 4-3
                              form: W
                          home:
                            - id: 2589310
                              startdate: '2026-08-30 13:00:00'
                              league:
                                id: 583
                                name: Premier League
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/583.png
                                country:
                                  id: 3
                                  name: England
                                  cc: en
                              teams:
                                home:
                                  id: 20
                                  name: Chelsea FC
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/20.png
                                away:
                                  id: 12
                                  name: Brighton & Hove Albion
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/12.png
                              scores:
                                home_score: '4'
                                away_score: '3'
                                ht_score: 3-1
                                ft_score: 4-3
                                et_score: null
                                ps_score: ''
                              ft_score: 4-3
                              form: W
                          away:
                            - id: 2589307
                              startdate: '2026-08-24 19:00:00'
                              league:
                                id: 583
                                name: Premier League
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/583.png
                                country:
                                  id: 3
                                  name: England
                                  cc: en
                              teams:
                                home:
                                  id: 262
                                  name: Fulham FC
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/262.png
                                away:
                                  id: 20
                                  name: Chelsea FC
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/20.png
                              scores:
                                home_score: '2'
                                away_score: '3'
                                ht_score: 1-2
                                ft_score: 2-3
                                et_score: null
                                ps_score: ''
                              ft_score: 2-3
                              form: W
                      away:
                        id: 12
                        name: Brighton & Hove Albion
                        img: https://cdn.soccersapi.com/images/soccer/teams/100/12.png
                        events:
                          overall:
                            - id: 2589310
                              startdate: '2026-08-30 13:00:00'
                              league:
                                id: 583
                                name: Premier League
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/583.png
                                country:
                                  id: 3
                                  name: England
                                  cc: en
                              teams:
                                home:
                                  id: 20
                                  name: Chelsea FC
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/20.png
                                away:
                                  id: 12
                                  name: Brighton & Hove Albion
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/12.png
                              scores:
                                home_score: '4'
                                away_score: '3'
                                ht_score: 3-1
                                ft_score: 4-3
                                et_score: null
                                ps_score: ''
                              ft_score: 4-3
                              form: L
                          home:
                            - id: 2649268
                              startdate: '2026-08-27 18:30:00'
                              league:
                                id: 4569
                                name: UEFA Europa Conference League
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/4569.png
                                country:
                                  id: 135
                                  name: Europe
                                  cc: ''
                              teams:
                                home:
                                  id: 12
                                  name: Brighton & Hove Albion
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/12.png
                                away:
                                  id: 373
                                  name: Tromsoe IL
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/373.png
                              scores:
                                home_score: '4'
                                away_score: '0'
                                ht_score: 3-0
                                ft_score: 4-0
                                et_score: null
                                ps_score: ''
                              ft_score: 4-0
                              form: W
                          away:
                            - id: 2589310
                              startdate: '2026-08-30 13:00:00'
                              league:
                                id: 583
                                name: Premier League
                                img: https://cdn.soccersapi.com/images/soccer/leagues/100/583.png
                                country:
                                  id: 3
                                  name: England
                                  cc: en
                              teams:
                                home:
                                  id: 20
                                  name: Chelsea FC
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/20.png
                                away:
                                  id: 12
                                  name: Brighton & Hove Albion
                                  img: https://cdn.soccersapi.com/images/soccer/teams/100/12.png
                              scores:
                                home_score: '4'
                                away_score: '3'
                                ht_score: 3-1
                                ft_score: 4-3
                                et_score: null
                                ps_score: ''
                              ft_score: 4-3
                              form: L
                      h2h:
                        - id: 2589310
                          startdate: '2026-08-30 13:00:00'
                          league:
                            id: 583
                            name: Premier League
                            img: https://cdn.soccersapi.com/images/soccer/leagues/100/583.png
                            country:
                              id: 3
                              name: England
                              cc: en
                          teams:
                            home:
                              id: 20
                              name: Chelsea FC
                              img: https://cdn.soccersapi.com/images/soccer/teams/100/20.png
                            away:
                              id: 12
                              name: Brighton & Hove Albion
                              img: https://cdn.soccersapi.com/images/soccer/teams/100/12.png
                          scores:
                            home_score: '4'
                            away_score: '3'
                            ht_score: 3-1
                            ft_score: 4-3
                            et_score: null
                            ps_score: ''
                          ft_score: 4-3
                          form: W
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/leaders/:
    get:
      summary: Leaders
      operationId: getLeaders
      tags:
        - Leaders
      description: |
        Season leaderboards.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `topscorers` | Top scorers. Players ranked by goals, with home and away split and penalties. | `season_id` | — |
        | `topassists` | Top assists. Players ranked by assists. | `season_id` | — |
        | `topcards` | Most cards. Yellow, yellow-red and red cards per player. | `season_id` | — |

        ## Examples

        Top scorers:

        ```http
        GET /v2.2/leaders/?user=USER&token=TOKEN&t=topscorers&season_id=12516
        ```

        Top assists:

        ```http
        GET /v2.2/leaders/?user=USER&token=TOKEN&t=topassists&season_id=12516
        ```

        Most cards:

        ```http
        GET /v2.2/leaders/?user=USER&token=TOKEN&t=topcards&season_id=12516
        ```
      x-operations:
        - t: topscorers
          title: Top scorers
          purpose: Players ranked by goals, with home and away split and penalties.
          required:
            - season_id
          optional: []
          schema: DataResponse
          example: season_id=12516
        - t: topassists
          title: Top assists
          purpose: Players ranked by assists.
          required:
            - season_id
          optional: []
          schema: DataResponse
          example: season_id=12516
        - t: topcards
          title: Most cards
          purpose: Yellow, yellow-red and red cards per player.
          required:
            - season_id
          optional: []
          schema: DataResponse
          example: season_id=12516
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: topscorers
          schema:
            type: string
            enum:
              - topscorers
              - topassists
              - topcards
            x-enumDescriptions:
              topscorers: Top scorers
              topassists: Top assists
              topcards: Most cards
        - name: season_id
          in: query
          required: true
          description: Season ID. Required by every operation.
          schema:
            type: string
          example: '12516'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                topscorers:
                  summary: Top scorers
                  value:
                    data:
                      - pos: 1
                        player:
                          id: '13201'
                          name: Haaland, Erling
                        team:
                          id: '4'
                          name: Manchester City
                        league_id: '583'
                        season_id: '12516'
                        matches_played: 35
                        minutes_played: 2776
                        substituted_in: 2
                        goals:
                          overall: 36
                          home: 22
                          away: 14
                        penalties: 7
                      - pos: 2
                        player:
                          id: '6395'
                          name: Kane, Harry
                        team:
                          id: '13'
                          name: Tottenham
                        league_id: '583'
                        season_id: '12516'
                        matches_played: 38
                        minutes_played: 3408
                        substituted_in: 0
                        goals:
                          overall: 30
                          home: 14
                          away: 16
                        penalties: 5
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 271
                      total: 271
                      msg: ''
                topassists:
                  summary: Top assists
                  value:
                    data:
                      - pos: 1
                        player:
                          id: '5249'
                          name: De Bruyne, Kevin
                        team:
                          id: '4'
                          name: Manchester City
                        league_id: '583'
                        season_id: '12516'
                        matches_played: 32
                        minutes_played: 2427
                        substituted_in: 4
                        assists: 16
                      - pos: 2
                        player:
                          id: '6390'
                          name: Salah, Mohamed
                        team:
                          id: '1'
                          name: Liverpool
                        league_id: '583'
                        season_id: '12516'
                        matches_played: 38
                        minutes_played: 3296
                        substituted_in: 1
                        assists: 13
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 267
                      total: 267
                      msg: ''
                topcards:
                  summary: Most cards
                  value:
                    data:
                      - pos: 1
                        player:
                          id: '18130'
                          name: Casemiro
                        team:
                          id: '19'
                          name: Manchester United
                        league_id: '583'
                        season_id: '12516'
                        matches_played: 28
                        minutes_played: 2127
                        substituted_in: 4
                        yellowcards: 9
                        yellowredcards: null
                        redcards: 2
                      - pos: 2
                        player:
                          id: '13154'
                          name: Semedo, Nelson
                        team:
                          id: '16'
                          name: Wolverhampton
                        league_id: '583'
                        season_id: '12516'
                        matches_played: 36
                        minutes_played: 2634
                        substituted_in: 5
                        yellowcards: 12
                        yellowredcards: null
                        redcards: 1
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 395
                      total: 395
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/bookmakers/:
    get:
      summary: Bookmakers
      operationId: getBookmakers
      tags:
        - Betting
      description: |
        Bookmaker catalogue used by the odds datasets.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `list` | All bookmakers. Every bookmaker with its logo. | — | — |
        | `info` | Bookmaker by ID. One bookmaker. | `id` | — |

        ## Examples

        All bookmakers:

        ```http
        GET /v2.2/bookmakers/?user=USER&token=TOKEN&t=list
        ```

        Bookmaker by ID:

        ```http
        GET /v2.2/bookmakers/?user=USER&token=TOKEN&t=info&id=2
        ```
      x-operations:
        - t: list
          title: All bookmakers
          purpose: Every bookmaker with its logo.
          required: []
          optional: []
          schema: DataResponse
          example: ''
        - t: info
          title: Bookmaker by ID
          purpose: One bookmaker.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=2
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: list
          schema:
            type: string
            enum:
              - list
              - info
            x-enumDescriptions:
              list: All bookmakers
              info: Bookmaker by ID
        - name: id
          in: query
          required: false
          description: Bookmaker ID. Required when `t` is `info`.
          schema:
            type: string
          example: '2'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                list:
                  summary: All bookmakers
                  value:
                    data:
                      - id: '1'
                        name: 10Bet
                        img: https://cdn.soccersapi.com/images/soccer/bookmakers/1.png
                      - id: '2'
                        name: bet365
                        img: https://cdn.soccersapi.com/images/soccer/bookmakers/2.png
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 39
                      total: 39
                      msg: ''
                info:
                  summary: Bookmaker by ID
                  value:
                    data:
                      id: '2'
                      name: bet365
                      img: https://cdn.soccersapi.com/images/soccer/bookmakers/2.png
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/markets/:
    get:
      summary: Markets
      operationId: getMarkets
      tags:
        - Betting
      description: |
        Betting market catalogue used by the odds datasets, such as 1X2, Asian handicap and over/under.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `list` | All markets. The eight markets in use: 1X2, over/under goal line, Asian handicap, first-half variants, Asian corners and half-time result. | — | — |
        | `info` | Market by ID. One betting market. | `id` | — |

        ## Examples

        All markets:

        ```http
        GET /v2.2/markets/?user=USER&token=TOKEN&t=list
        ```

        Market by ID:

        ```http
        GET /v2.2/markets/?user=USER&token=TOKEN&t=info&id=1
        ```
      x-operations:
        - t: list
          title: All markets
          purpose: 'The eight markets in use: 1X2, over/under goal line, Asian handicap, first-half variants, Asian corners and half-time result.'
          required: []
          optional: []
          schema: DataResponse
          example: ''
        - t: info
          title: Market by ID
          purpose: One betting market.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=1
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: list
          schema:
            type: string
            enum:
              - list
              - info
            x-enumDescriptions:
              list: All markets
              info: Market by ID
        - name: id
          in: query
          required: false
          description: Market ID. Required when `t` is `info`.
          schema:
            type: string
          example: '1'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                list:
                  summary: All markets
                  value:
                    data:
                      - id: '1'
                        name: 1X2, Full Time Result
                      - id: '2'
                        name: Over/Under, Goal Line
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 8
                      total: 8
                      msg: ''
                info:
                  summary: Market by ID
                  value:
                    data:
                      id: '1'
                      name: 1X2, Full Time Result
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/broadcast/:
    get:
      summary: Broadcast and TV channels
      operationId: getBroadcasts
      tags:
        - Broadcast
      description: |
        TV schedules and the TV channel catalogue. Use these operations, the fixture include `broadcast` and the fixture operation `t=tv` to build "where to watch" features.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored. The theme column marks datasets that themed plans (Odds, Broadcast) include only for their own theme; Free and Standard plans include every theme for their leagues.

        | `t` | Operation | Required | Optional | Theme |
        | --- | --- | --- | --- | --- |
        | `schedule` | Matches on TV by date. Matches broadcast on a date. Add `include=tvs` to embed the channel details in each match. Paginated, 100 items per page. | `d` | `include`, `utc`, `lang`, `page` | broadcast |
        | `match_tvs` | TV channels of a match. Every channel showing the match, with its country. Not paginated. | `id` | — | broadcast |
        | `list` | TV channels. All TV channels, optionally filtered by country. Paginated, 100 items per page. | — | `country_id`, `page` | broadcast |
        | `info` | TV channel by ID. One TV channel with type, logo, website and country. | `id` | — | broadcast |

        ## Includes

        Comma-separated dataset names for `include`, without spaces:

        - `tvs`: channel details embedded in each match of `schedule`

        ## Examples

        Matches on TV by date:

        ```http
        GET /v2.2/broadcast/?user=USER&token=TOKEN&t=schedule&d=2026-08-30&include=tvs&utc=2
        ```

        TV channels of a match:

        ```http
        GET /v2.2/broadcast/?user=USER&token=TOKEN&t=match_tvs&id=2589310
        ```

        TV channels:

        ```http
        GET /v2.2/broadcast/?user=USER&token=TOKEN&t=list&country_id=15
        ```

        TV channel by ID:

        ```http
        GET /v2.2/broadcast/?user=USER&token=TOKEN&t=info&id=2
        ```
      x-operations:
        - t: schedule
          title: Matches on TV by date
          purpose: Matches broadcast on a date. Add `include=tvs` to embed the channel details in each match. Paginated, 100 items per page.
          required:
            - d
          optional:
            - include
            - utc
            - lang
            - page
          schema: MatchListResponse
          paginated: true
          theme: broadcast
          example: d=2026-08-30&include=tvs&utc=2
        - t: match_tvs
          title: TV channels of a match
          purpose: Every channel showing the match, with its country. Not paginated.
          required:
            - id
          optional: []
          schema: TvChannelListResponse
          theme: broadcast
          example: id=2589310
        - t: list
          title: TV channels
          purpose: All TV channels, optionally filtered by country. Paginated, 100 items per page.
          required: []
          optional:
            - country_id
            - page
          schema: TvChannelListResponse
          paginated: true
          theme: broadcast
          example: country_id=15
        - t: info
          title: TV channel by ID
          purpose: One TV channel with type, logo, website and country.
          required:
            - id
          optional: []
          schema: TvChannelDetailResponse
          theme: broadcast
          example: id=2
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: schedule
          schema:
            type: string
            enum:
              - schedule
              - match_tvs
              - list
              - info
            x-enumDescriptions:
              schedule: Matches on TV by date
              match_tvs: TV channels of a match
              list: TV channels
              info: TV channel by ID
        - name: id
          in: query
          required: false
          description: TV channel ID for `info`; match ID for `match_tvs`. Required when `t` is `match_tvs`, `info`.
          schema:
            type: string
          example: '2'
        - name: d
          in: query
          required: false
          description: Calendar date in `YYYY-MM-DD` format. Required when `t` is `schedule`.
          schema:
            type: string
            format: date
          example: '2026-08-30'
        - name: country_id
          in: query
          required: false
          description: Country ID. Optional for `list`.
          schema:
            type: string
          example: '15'
        - name: include
          in: query
          required: false
          description: 'Comma-separated datasets to embed in the response, without spaces. Supported values: `tvs`. See the includes section.'
          example: tvs
          schema:
            type: string
        - $ref: '#/components/parameters/Utc'
        - $ref: '#/components/parameters/Lang'
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: |-
            The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.

            - `t=schedule`: MatchListResponse
            - `t=match_tvs`: TvChannelListResponse
            - `t=list`: TvChannelListResponse
            - `t=info`: TvChannelDetailResponse
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/MatchListResponse'
                  - $ref: '#/components/schemas/TvChannelListResponse'
                  - $ref: '#/components/schemas/TvChannelDetailResponse'
              examples:
                schedule:
                  summary: Matches on TV by date
                  value:
                    data:
                      - id: 2602155
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '217130'
                        round_name: '6'
                        season_id: '21080'
                        season_name: 26/27
                        stage_id: '3'
                        stage_name: Apertura
                        group_id: '1'
                        group_name: Apertura
                        aggregate_id: null
                        winner_team_id: '19346'
                        venue_id: '5741'
                        leg: null
                        week: '35'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-08-30 00:00:00'
                          date: '2026-08-30'
                          time: '00:00:00'
                          minute: 90
                          timestamp: 1788048000
                          timezone: UTC+2
                        teams:
                          home:
                            id: 19346
                            name: Tlaxcala FC
                            short_code: TLA
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/19346.png
                            form: null
                            coach_id: null
                            kit_colors:
                              home_main_color: '#d8d8d8'
                              home_second_color: '#d8d8d8'
                              home_number_color: '#000000'
                              home_gk_main_color: '#efc131'
                              home_gk_second_color: '#333333'
                              home_gk_number_color: '#000000'
                          away:
                            id: 6946
                            name: Venados  FC
                            short_code: VDS
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/6946.png
                            form: null
                            coach_id: null
                            kit_colors:
                              away_main_color: '#ccff00'
                              away_second_color: '#ccff00'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#660066'
                              away_gk_second_color: '#000000'
                              away_gk_number_color: '#000000'
                        league:
                          id: 2798
                          name: Liga de Ascenso, Apertura
                          type: Apertura
                          country_id: '76'
                          country_name: Mexico
                          country_code: mx
                          country_flag: https://cdn.soccersapi.com/images/countries/30/mx.png
                        scores:
                          home_score: '3'
                          away_score: '1'
                          ht_score: 1-0
                          ft_score: 3-1
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 16
                          away_position: 6
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 0
                          has_tvs: 1
                          has_standings: 1
                        weather_report:
                          desc: thunderstorm
                          temp:
                            celsius: 17.9
                            fahrenheit: 64.2
                          wind:
                            kmph: 9.6
                            miles: 5.97
                            direction: 'N'
                          humidity_percent: 77
                          pressure: 1016
                        tvs:
                          - id: 11700
                            name: Disney+ Caribbean
                            type: '1'
                            country:
                              id: 151
                              name: Anguilla
                              cc: ai
                      - id: 2544691
                        status: 3
                        status_name: Finished
                        status_period: null
                        pitch: null
                        referee_id: null
                        round_id: '211353'
                        round_name: '1'
                        season_id: '16106'
                        season_name: '2026'
                        stage_id: '2008'
                        stage_name: Regular Season - National Womens Soccer League 2026
                        group_id: '12857'
                        group_name: National Womens Soccer League 2026
                        aggregate_id: null
                        winner_team_id: '294035372'
                        venue_id: '9122'
                        leg: null
                        week: '35'
                        deleted: '0'
                        info: null
                        related_id: null
                        attendance: null
                        time:
                          datetime: '2026-08-30 00:30:00'
                          date: '2026-08-30'
                          time: '00:30:00'
                          minute: 90
                          timestamp: 1788049800
                          timezone: UTC+2
                        teams:
                          home:
                            id: 294035372
                            name: Kansas City NWSL
                            short_code: KC
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/294035372.png
                            form: null
                            coach_id: '1616'
                            kit_colors:
                              home_main_color: '#a71212'
                              home_second_color: '#7bb4af'
                              home_number_color: '#d7eee2'
                              home_gk_main_color: '#cdcf64'
                              home_gk_second_color: '#c193b1'
                              home_gk_number_color: '#050505'
                          away:
                            id: 7086
                            name: North Carolina Courage (W)
                            short_code: NCC
                            img: https://cdn.soccersapi.com/images/soccer/teams/80/7086.png
                            form: null
                            coach_id: '12877'
                            kit_colors:
                              away_main_color: '#213973'
                              away_second_color: '#8c1123'
                              away_number_color: '#ffffff'
                              away_gk_main_color: '#eed4fd'
                              away_gk_second_color: '#04e600'
                              away_gk_number_color: '#000000'
                        league:
                          id: 3702
                          name: National Womens Soccer League
                          type: National Womens Soccer League 2026
                          country_id: '124'
                          country_name: USA
                          country_code: us
                          country_flag: https://cdn.soccersapi.com/images/countries/30/us.png
                        scores:
                          home_score: '3'
                          away_score: '2'
                          ht_score: 3-1
                          ft_score: 3-2
                          et_score: null
                          ps_score: null
                        standings:
                          home_position: 7
                          away_position: 5
                        assistants:
                          first_assistant_id: null
                          second_assistant_id: null
                          fourth_assistant_id: null
                        coverage:
                          has_lineups: 1
                          has_tvs: 1
                          has_standings: 1
                        weather_report:
                          desc: clear/sunny
                          temp:
                            celsius: 35.2
                            fahrenheit: 95.4
                          wind:
                            kmph: 16.3
                            miles: 10.13
                            direction: S
                          humidity_percent: 38
                          pressure: 1011
                        tvs:
                          - id: 5805
                            name: Stan Sport
                            type: Tv / Cable / Satellite
                            country:
                              id: 14
                              name: Australia
                              cc: au
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 3
                      count: 100
                      total: 215
                      msg: ''
                match_tvs:
                  summary: TV channels of a match
                  value:
                    data:
                      - id: 187
                        name: SuperSport 3 Digitalb
                        type: Tv / Cable / Satellite
                        country:
                          id: 8
                          name: Albania
                          cc: al
                      - id: 55
                        name: beIN SPORTS CONNECT
                        type: Tv / Cable / Satellite
                        country:
                          id: 9
                          name: Algeria
                          cc: dz
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 535
                      total: 535
                      msg: ''
                list:
                  summary: TV channels
                  value:
                    data:
                      - id: '31'
                        name: Sky Go
                        type: Tv / Cable / Satellite
                        img: https://cdn.soccersapi.com/images/tvchannels/100/31.png
                        channel_url: https://www.sky.de/
                        country:
                          id: '15'
                          name: Austria
                          cc: at
                      - id: '32'
                        name: Sky Sport Bundesliga 1
                        type: Tv / Cable / Satellite
                        img: https://cdn.soccersapi.com/images/tvchannels/100/32.png
                        channel_url: https://www.sky.de/fussball-2434?shurl=sport
                        country:
                          id: '15'
                          name: Austria
                          cc: at
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 2
                      count: 100
                      total: 124
                      msg: ''
                info:
                  summary: TV channel by ID
                  value:
                    data:
                      id: '2'
                      name: DIRECTV Sports Argentina
                      type: Tv / Cable / Satellite
                      img: https://cdn.soccersapi.com/images/tvchannels/100/2.png
                      channel_url: https://www.directvsports.com/
                      country:
                        id: '12'
                        name: Argentina
                        cc: ar
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/players/:
    get:
      summary: Players
      operationId: getPlayers
      tags:
        - People
      description: |
        Player profiles with biography, current team, national team, market value and season roles.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `info` | Player by ID. Player profile with biography, current team, market value, leagues and roles by season. | `id` | — |
        | `list` | All players. All players, or the players of a country. Paginated, 100 items per page. | — | `country_id`, `page` |

        ## Examples

        Player by ID:

        ```http
        GET /v2.2/players/?user=USER&token=TOKEN&t=info&id=11306
        ```

        All players:

        ```http
        GET /v2.2/players/?user=USER&token=TOKEN&t=list&country_id=4
        ```
      x-operations:
        - t: info
          title: Player by ID
          purpose: Player profile with biography, current team, market value, leagues and roles by season.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=11306
        - t: list
          title: All players
          purpose: All players, or the players of a country. Paginated, 100 items per page.
          required: []
          optional:
            - country_id
            - page
          schema: DataResponse
          paginated: true
          example: country_id=4
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: info
          schema:
            type: string
            enum:
              - info
              - list
            x-enumDescriptions:
              info: Player by ID
              list: All players
        - name: id
          in: query
          required: false
          description: Player ID. Required when `t` is `info`.
          schema:
            type: string
          example: '11306'
        - name: country_id
          in: query
          required: false
          description: Country ID. Optional for `list`.
          schema:
            type: string
          example: '4'
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                info:
                  summary: Player by ID
                  value:
                    data:
                      id: 11306
                      team_id: 5
                      national_team_id: null
                      name: Adam Smith
                      common_name: Smith
                      position: D
                      firstname: Adam
                      lastname: Smith
                      birthday: '1991-04-29'
                      birthcountry: null
                      birthplace: null
                      shirtnumber: 15
                      weight: 78
                      height: 180
                      age: 35
                      foot: Right
                      img: https://cdn.soccersapi.com/images/soccer/players/50/11306.png
                      market_value: $5.500000
                      country:
                        id: 3
                        name: England
                        cc: en
                      leagues:
                        - id: 583
                          name: Premier League
                          is_cup: false
                          is_amateur: false
                          is_friendly: false
                          seasons:
                            - id: 21033
                              name: 26/27
                              is_current: 1
                      roles:
                        - team:
                            id: 5
                            name: Bournemouth
                            is_national: 0
                          is_current: true
                          role: player
                          start: null
                          end: null
                          shirt: 15
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                list:
                  summary: All players
                  value:
                    data:
                      - id: 195
                        team_id: null
                        national_team_id: null
                        name: Mart Ristl
                        common_name: Ristl, Mart
                        position: M
                        firstname: Mart
                        lastname: Ristl
                        birthday: '1996-07-07'
                        birthcountry: null
                        birthplace: null
                        shirtnumber: null
                        weight: 74
                        height: 178
                        age: 30
                        foot: right
                        img: https://cdn.soccersapi.com/images/soccer/players/50/195.png
                        market_value: null
                        country:
                          id: 4
                          name: Germany
                          cc: de
                      - id: 198
                        team_id: null
                        national_team_id: null
                        name: Dennis Jastrzembski
                        common_name: Jastrzembski, Dennis
                        position: F
                        firstname: Dennis
                        lastname: Jastrzembski
                        birthday: '2000-02-20'
                        birthcountry: null
                        birthplace: null
                        shirtnumber: null
                        weight: 77
                        height: 176
                        age: 26
                        foot: null
                        img: https://cdn.soccersapi.com/images/soccer/players/50/198.png
                        market_value: $660000
                        country:
                          id: 4
                          name: Germany
                          cc: de
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 100
                      count: 100
                      total: 9935
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/coaches/:
    get:
      summary: Coaches
      operationId: getCoaches
      tags:
        - People
      description: |
        Coach profiles.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `info` | Coach by ID. Coach profile with current team and country. | `id` | — |
        | `list` | All coaches. All coaches, or the coaches of a country. Paginated, 100 items per page. | — | `country_id`, `page` |

        ## Examples

        Coach by ID:

        ```http
        GET /v2.2/coaches/?user=USER&token=TOKEN&t=info&id=662
        ```

        All coaches:

        ```http
        GET /v2.2/coaches/?user=USER&token=TOKEN&t=list&country_id=25
        ```
      x-operations:
        - t: info
          title: Coach by ID
          purpose: Coach profile with current team and country.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=662
        - t: list
          title: All coaches
          purpose: All coaches, or the coaches of a country. Paginated, 100 items per page.
          required: []
          optional:
            - country_id
            - page
          schema: DataResponse
          paginated: true
          example: country_id=25
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: info
          schema:
            type: string
            enum:
              - info
              - list
            x-enumDescriptions:
              info: Coach by ID
              list: All coaches
        - name: id
          in: query
          required: false
          description: Coach ID. Required when `t` is `info`.
          schema:
            type: string
          example: '662'
        - name: country_id
          in: query
          required: false
          description: Country ID. Optional for `list`.
          schema:
            type: string
          example: '25'
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                info:
                  summary: Coach by ID
                  value:
                    data:
                      id: 662
                      team_id: 99
                      name: Hans-Dieter Flick
                      common_name: Flick
                      firstname: Hans-Dieter
                      lastname: Flick
                      birthday: '2065-02-24'
                      birthcountry: null
                      birthplace: null
                      img: https://cdn.soccersapi.com/images/soccer/coaches/50/662.png
                      country:
                        id: 4
                        name: Germany
                        cc: de
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                list:
                  summary: All coaches
                  value:
                    data:
                      - id: 3
                        team_id: 2217
                        name: Roger Machado
                        common_name: Machado
                        firstname: Roger
                        lastname: Machado
                        birthday: '1975-04-25'
                        birthcountry: null
                        birthplace: null
                        img: https://cdn.soccersapi.com/images/soccer/coaches/50/3.png
                        country:
                          id: 25
                          name: Brazil
                          cc: br
                      - id: 19
                        team_id: 3244
                        name: Tiago Nunes
                        common_name: Nunes
                        firstname: Tiago
                        lastname: Nunes
                        birthday: '1980-02-15'
                        birthcountry: null
                        birthplace: null
                        img: https://cdn.soccersapi.com/images/soccer/coaches/50/19.png
                        country:
                          id: 25
                          name: Brazil
                          cc: br
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 3
                      count: 100
                      total: 211
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/referees/:
    get:
      summary: Referees
      operationId: getReferees
      tags:
        - People
      description: |
        Referee profiles.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `info` | Referee by ID. Referee profile with country. | `id` | — |
        | `list` | All referees. All referees, or the referees of a country. Paginated, 100 items per page. | — | `country_id`, `page` |

        ## Examples

        Referee by ID:

        ```http
        GET /v2.2/referees/?user=USER&token=TOKEN&t=info&id=372
        ```

        All referees:

        ```http
        GET /v2.2/referees/?user=USER&token=TOKEN&t=list&country_id=4
        ```
      x-operations:
        - t: info
          title: Referee by ID
          purpose: Referee profile with country.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=372
        - t: list
          title: All referees
          purpose: All referees, or the referees of a country. Paginated, 100 items per page.
          required: []
          optional:
            - country_id
            - page
          schema: DataResponse
          paginated: true
          example: country_id=4
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: info
          schema:
            type: string
            enum:
              - info
              - list
            x-enumDescriptions:
              info: Referee by ID
              list: All referees
        - name: id
          in: query
          required: false
          description: Referee ID. Required when `t` is `info`.
          schema:
            type: string
          example: '372'
        - name: country_id
          in: query
          required: false
          description: Country ID. Optional for `list`.
          schema:
            type: string
          example: '4'
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                info:
                  summary: Referee by ID
                  value:
                    data:
                      id: 372
                      name: Deniz Aytekin
                      common_name: Aytekin
                      firstname: Deniz
                      lastname: Aytekin
                      birthday: '1978-07-21'
                      img: https://cdn.soccersapi.com/images/soccer/referees/50/372.png
                      country:
                        id: 4
                        name: Germany
                        cc: de
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
                list:
                  summary: All referees
                  value:
                    data:
                      - id: 22
                        name: Harm Osmers
                        common_name: Osmers
                        firstname: Harm
                        lastname: Osmers
                        birthday: '1985-01-28'
                        img: https://cdn.soccersapi.com/images/soccer/referees/50/22.png
                        country:
                          id: 4
                          name: Germany
                          cc: de
                      - id: 23
                        name: Patrick Ittrich
                        common_name: Ittrich
                        firstname: Patrick
                        lastname: Ittrich
                        birthday: '1979-01-03'
                        img: https://cdn.soccersapi.com/images/soccer/referees/50/23.png
                        country:
                          id: 4
                          name: Germany
                          cc: de
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 4
                      count: 100
                      total: 343
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/venues/:
    get:
      summary: Venues
      operationId: getVenues
      tags:
        - Venues
      description: |
        Stadiums with capacity, city, coordinates and images in several sizes.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `list` | All venues. All venues, or the venues of a country. Paginated, 100 items per page. | — | `country_id`, `page` |
        | `byseason` | Venues by season. Venues of the teams taking part in a season. | `season_id` | — |
        | `info` | Venue by ID. One venue with capacity, city, coordinates and image. | `id` | — |

        ## Examples

        All venues:

        ```http
        GET /v2.2/venues/?user=USER&token=TOKEN&t=list&country_id=15
        ```

        Venues by season:

        ```http
        GET /v2.2/venues/?user=USER&token=TOKEN&t=byseason&season_id=14192
        ```

        Venue by ID:

        ```http
        GET /v2.2/venues/?user=USER&token=TOKEN&t=info&id=191
        ```
      x-operations:
        - t: list
          title: All venues
          purpose: All venues, or the venues of a country. Paginated, 100 items per page.
          required: []
          optional:
            - country_id
            - page
          schema: DataResponse
          paginated: true
          example: country_id=15
        - t: byseason
          title: Venues by season
          purpose: Venues of the teams taking part in a season.
          required:
            - season_id
          optional: []
          schema: DataResponse
          example: season_id=14192
        - t: info
          title: Venue by ID
          purpose: One venue with capacity, city, coordinates and image.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=191
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: list
          schema:
            type: string
            enum:
              - list
              - byseason
              - info
            x-enumDescriptions:
              list: All venues
              byseason: Venues by season
              info: Venue by ID
        - name: id
          in: query
          required: false
          description: Venue ID. Required when `t` is `info`.
          schema:
            type: string
          example: '191'
        - name: country_id
          in: query
          required: false
          description: Country ID. Optional for `list`.
          schema:
            type: string
          example: '15'
        - name: season_id
          in: query
          required: false
          description: Season ID. Required when `t` is `byseason`.
          schema:
            type: string
          example: '14192'
        - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                list:
                  summary: All venues
                  value:
                    data:
                      - id: 191
                        name: Cashpoint Arena
                        capacity: 8500
                        city: Altach
                        address: null
                        img: https://cdn.soccersapi.com/images/soccer/venues/191.png
                        coordinates:
                          lat: '47.353889'
                          long: '9.636667'
                        country:
                          id: 15
                          name: Austria
                          continent: Europe
                          sub_region: null
                          long: null
                          lat: null
                          img: https://cdn.soccersapi.com/images/countries/30/at.png
                          code: at
                          cc: at
                      - id: 192
                        name: Lavanttal-Arena
                        capacity: 7300
                        city: Wolfsberg
                        address: null
                        img: https://cdn.soccersapi.com/images/soccer/venues/192.png
                        coordinates:
                          lat: '46.826258'
                          long: '14.851989'
                        country:
                          id: 15
                          name: Austria
                          continent: Europe
                          sub_region: null
                          long: null
                          lat: null
                          img: https://cdn.soccersapi.com/images/countries/30/at.png
                          code: at
                          cc: at
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 2
                      count: 100
                      total: 173
                      msg: ''
                byseason:
                  summary: Venues by season
                  value:
                    data:
                      - id: 5502
                        name: ATCO Field
                        capacity: 5288
                        city: Foothills County
                        address: null
                        img: https://cdn.soccersapi.com/images/soccer/venues/5502.png
                        coordinates:
                          lat: '50.883813'
                          long: '-114.098839'
                        country:
                          id: 28
                          name: Canada
                          continent: North America
                          sub_region: null
                          long: null
                          lat: null
                          img: https://cdn.soccersapi.com/images/countries/30/ca.png
                          code: ca
                          cc: ca
                      - id: 4458
                        name: TD Place Stadium
                        capacity: 24000
                        city: Ottawa
                        address: 1015 Bank Street
                        img: https://cdn.soccersapi.com/images/soccer/venues/4458.png
                        coordinates:
                          lat: '45.398178'
                          long: '-75.683650'
                        country:
                          id: 28
                          name: Canada
                          continent: North America
                          sub_region: null
                          long: null
                          lat: null
                          img: https://cdn.soccersapi.com/images/countries/30/ca.png
                          code: ca
                          cc: ca
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 8
                      total: 8
                      msg: ''
                info:
                  summary: Venue by ID
                  value:
                    data:
                      id: 191
                      name: Cashpoint Arena
                      capacity: 8500
                      city: Altach
                      address: null
                      img: https://cdn.soccersapi.com/images/soccer/venues/191.png
                      coordinates:
                        lat: '47.353889'
                        long: '9.636667'
                      country:
                        id: 15
                        name: Austria
                        continent: Europe
                        sub_region: null
                        long: null
                        lat: null
                        img: https://cdn.soccersapi.com/images/countries/30/at.png
                        code: at
                        cc: at
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      page: 1
                      pages: 1
                      count: 1
                      total: 1
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
  /v2.2/media/:
    get:
      summary: Media highlights (coming soon)
      operationId: getMedia
      tags:
        - Media
      description: |
        **Coming soon.** This route is not available yet on production.
        Video highlights by league, season, team, round, match or date. The route is documented ahead of its release: it is not available yet and currently answers `404 Endpoint not found`. Operations, parameters and the response shape can change before launch. `data` is an array of highlight groups, each an array of highlight objects with title, thumbnail, URL and source.

        ## Operations

        The `t` query parameter selects the operation. Parameters not listed for an operation are ignored.

        | `t` | Operation | Required | Optional |
        | --- | --- | --- | --- |
        | `league` | Highlights by league. Highlight videos of the matches of a league. | `id` | — |
        | `season` | Highlights by season. Highlight videos of the matches of a season. | `id` | — |
        | `team` | Highlights by team. Highlight videos of the matches of a team. | `id` | — |
        | `round` | Highlights by round. Highlight videos of the matches of a round. | `id` | — |
        | `event` | Highlights by match. Highlight videos of one match. | `id` | — |
        | `date` | Highlights by date. Highlight videos of the matches of a date. | `d` | — |

        ## Examples

        Highlights by league:

        ```http
        GET /v2.2/media/?user=USER&token=TOKEN&t=league&id=637
        ```

        Highlights by season:

        ```http
        GET /v2.2/media/?user=USER&token=TOKEN&t=season&id=14341
        ```

        Highlights by team:

        ```http
        GET /v2.2/media/?user=USER&token=TOKEN&t=team&id=116
        ```

        Highlights by round:

        ```http
        GET /v2.2/media/?user=USER&token=TOKEN&t=round&id=182349
        ```

        Highlights by match:

        ```http
        GET /v2.2/media/?user=USER&token=TOKEN&t=event&id=1843815
        ```

        Highlights by date:

        ```http
        GET /v2.2/media/?user=USER&token=TOKEN&t=date&d=2026-08-30
        ```
      x-status: coming-soon
      x-operations:
        - t: league
          title: Highlights by league
          purpose: Highlight videos of the matches of a league.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=637
        - t: season
          title: Highlights by season
          purpose: Highlight videos of the matches of a season.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=14341
        - t: team
          title: Highlights by team
          purpose: Highlight videos of the matches of a team.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=116
        - t: round
          title: Highlights by round
          purpose: Highlight videos of the matches of a round.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=182349
        - t: event
          title: Highlights by match
          purpose: Highlight videos of one match.
          required:
            - id
          optional: []
          schema: DataResponse
          example: id=1843815
        - t: date
          title: Highlights by date
          purpose: Highlight videos of the matches of a date.
          required:
            - d
          optional: []
          schema: DataResponse
          example: d=2026-08-30
      parameters:
        - $ref: '#/components/parameters/User'
        - $ref: '#/components/parameters/Token'
        - name: t
          in: query
          required: true
          description: Operation selector. See the operations table.
          example: league
          schema:
            type: string
            enum:
              - league
              - season
              - team
              - round
              - event
              - date
            x-enumDescriptions:
              league: Highlights by league
              season: Highlights by season
              team: Highlights by team
              round: Highlights by round
              event: Highlights by match
              date: Highlights by date
        - name: id
          in: query
          required: false
          description: ID of the league, season, team, round or match selected by `t`. Required when `t` is `league`, `season`, `team`, `round`, `event`.
          schema:
            type: string
          example: '637'
        - name: d
          in: query
          required: false
          description: Calendar date in `YYYY-MM-DD` format for `t=date`. Required when `t` is `date`.
          schema:
            type: string
            format: date
          example: '2026-08-30'
      responses:
        '200':
          description: 'The `data` shape depends on `t`: an object for single-resource operations and an array for lists. `meta` carries the request allowance and pagination.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResponse'
              examples:
                league:
                  summary: Highlights by league
                  value:
                    data:
                      - - id: 1843815
                          league_id: 637
                          season_id: 14341
                          home_id: 116
                          away_id: 118
                          round_id: 182349
                          stage_id: 207
                          group_id: 1
                          startdate: '2024-11-24 20:00:00'
                          title: ATHLETIC CLUB 1 - 0 REAL SOCIEDAD I RESUMEN LALIGA EA SPORTS
                          image: https://i.ytimg.com/vi/aVy9O_x1Fe8/maxresdefault.jpg
                          url: https://www.youtube.com/watch?v=aVy9O_x1Fe8
                          source: www.youtube.com
                        - id: 1843819
                          league_id: 637
                          season_id: 14341
                          home_id: 121
                          away_id: 113
                          round_id: 182349
                          stage_id: 207
                          group_id: 1
                          startdate: '2024-11-24 17:30:00'
                          title: CD LEGANÉS 0 - 3 REAL MADRID I RESUMEN LALIGA EA SPORTS
                          image: https://i.ytimg.com/vi/pQVtyVtkGfM/maxresdefault.jpg
                          url: https://www.youtube.com/watch?v=pQVtyVtkGfM
                          source: www.youtube.com
                        - id: 1843819
                          league_id: 637
                          season_id: 14341
                          home_id: 121
                          away_id: 113
                          round_id: 182349
                          stage_id: 207
                          group_id: 1
                          startdate: '2024-11-24 17:30:00'
                          title: CD LEGANÉS 0 - 3 REAL MADRID I RESUMEN LALIGA EA SPORTS
                          image: https://i.ytimg.com/vi/9lStg3L28xQ/maxresdefault.jpg
                          url: https://www.youtube.com/watch?v=9lStg3L28xQ
                          source: www.youtube.com
                    meta:
                      requests_left: 2950
                      user: your_username
                      plan: Soccer API 50
                      pages: 1
                      page: 1
                      total: 56
                      msg: ''
        '400':
          description: Invalid `t` value, invalid parameter value or missing operation-specific parameter.
        '401':
          description: Missing or invalid `user` or `token`.
        '403':
          description: The league, dataset or operation is not available on the account plan.
        '429':
          description: Request allowance exhausted.
        4XX:
          $ref: '#/components/responses/ClientError'
webhooks: {}
components:
  parameters:
    User:
      name: user
      in: query
      required: true
      description: Account username.
      example: '{{USERNAME}}'
      schema:
        type: string
    Token:
      name: token
      in: query
      required: true
      description: API token generated in the account dashboard.
      example: '{{TOKEN}}'
      schema:
        type: string
    Utc:
      name: utc
      in: query
      required: false
      description: UTC offset applied to returned date/time values; `time.timezone` reports it, for example `UTC+4.5`. Decimal offsets are accepted and invalid values fall back to UTC.
      example: 2
      schema:
        type: number
        minimum: -12
        maximum: 14
    Lang:
      name: lang
      in: query
      required: false
      description: Language code for localized names, for example `en`, `es`, `de`, `fr`, `it`, `pt`, `tr`, `pl`, `ko` or `zh`. Verified on country, continent and league catalogue names; match and statistics payloads are not translated.
      example: en
      schema:
        type: string
    Page:
      name: page
      in: query
      required: false
      description: Page number on paginated operations, starting at 1. The response reports `meta.page` and `meta.pages`; a page beyond the last returns an empty `data`.
      example: 1
      schema:
        type: integer
        minimum: 1
    OddsFormat:
      name: odds_format
      in: query
      required: false
      description: 'Odds format on odds datasets: `decimal` (default), `fractional` or `american`.'
      example: decimal
      schema:
        type: string
        enum:
          - decimal
          - fractional
          - american
  responses:
    ClientError:
      description: |-
        Client error. Depending on the status, the request can contain invalid
        parameters, invalid credentials, unavailable plan data, an unknown
        resource or an exhausted request allowance. Inspect the HTTP status and
        `msg`/`meta.msg` when present.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    DataResponse:
      type: object
      required:
        - data
        - meta
      description: Generic envelope. `data` is an object for single-resource operations and an array for lists; see the operation description and example for the shape.
      properties:
        data: {}
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      additionalProperties: true
    ErrorResponse:
      type: object
      description: Error body. `401` returns `ok`/`message`; `400` and unknown-resource `404` return the normal envelope with an empty `data` and the reason in `meta.msg`; an unknown route returns `msg` only.
      properties:
        ok:
          type: boolean
        message:
          type: string
        msg:
          type:
            - string
            - 'null'
        data: {}
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      additionalProperties: true
    SearchResult:
      type: object
      description: One search result. `type` tells which entity the ID belongs to.
      properties:
        id:
          $ref: '#/components/schemas/FlexibleId'
        name:
          type: string
        type:
          type: string
          description: 'Entity type: `match`, `league`, `team`, `player`, `referee`, `country`, `continent` or `channel / broadcast`.'
        startdate:
          type:
            - string
            - 'null'
          description: Kickoff date and time for match results, in the `utc` offset when given.
        home:
          type:
            - string
            - 'null'
        away:
          type:
            - string
            - 'null'
        league_name:
          type:
            - string
            - 'null'
        country_name:
          type:
            - string
            - 'null'
        cc:
          type:
            - string
            - 'null'
          description: Country code.
      required:
        - id
        - name
        - type
      additionalProperties: true
    SearchResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/SearchResult'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
    MatchTeam:
      type: object
      description: Team side of a match.
      properties:
        id:
          $ref: '#/components/schemas/FlexibleId'
        name:
          type: string
        short_code:
          type:
            - string
            - 'null'
        img:
          type:
            - string
            - 'null'
          description: Logo URL.
        form:
          type:
            - string
            - 'null'
        coach_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        kit_colors:
          type:
            - object
            - 'null'
          description: Hex colours of the kit worn in this match (`home_*` keys for the home side, `away_*` for the away side).
          additionalProperties: true
      additionalProperties: true
    Match:
      type: object
      description: Match snapshot returned by livescores, fixture lists, `fixtures?t=info` and `broadcast?t=schedule`. Datasets requested with `include` appear as extra properties (`events`, `stats`, `broadcast`, `tvs`, `odds_prematch`, `odds_inplay`).
      properties:
        id:
          $ref: '#/components/schemas/FlexibleId'
        status:
          oneOf:
            - type: integer
            - type: string
          description: Status code; see the Statuses guide.
        status_name:
          type: string
        status_period:
          type:
            - string
            - 'null'
        pitch:
          type:
            - string
            - 'null'
        referee_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        round_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        round_name:
          type:
            - string
            - 'null'
        season_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        season_name:
          type:
            - string
            - 'null'
        stage_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        stage_name:
          type:
            - string
            - 'null'
        group_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        group_name:
          type:
            - string
            - 'null'
        aggregate_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        winner_team_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        venue_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        leg:
          type:
            - string
            - 'null'
        week:
          type:
            - string
            - 'null'
        deleted:
          type:
            - string
            - integer
            - 'null'
          description: '`1` when the match was removed from the schedule.'
        related_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        info:
          type:
            - string
            - 'null'
          description: Federation decisions or special notes.
        attendance:
          type:
            - integer
            - string
            - 'null'
        time:
          type: object
          properties:
            datetime:
              type: string
            date:
              type: string
              format: date
            time:
              type: string
            minute:
              $ref: '#/components/schemas/NullableMinute'
            timestamp:
              oneOf:
                - type: integer
                - type: string
                - type: 'null'
              description: Unix timestamp of the kickoff.
            timezone:
              type: string
          additionalProperties: true
        teams:
          type: object
          properties:
            home:
              $ref: '#/components/schemas/MatchTeam'
            away:
              $ref: '#/components/schemas/MatchTeam'
          additionalProperties: true
        league:
          type: object
          properties:
            id:
              $ref: '#/components/schemas/FlexibleId'
            name:
              type: string
            type:
              type:
                - string
                - 'null'
            country_id:
              $ref: '#/components/schemas/NullableFlexibleId'
            country_name:
              type:
                - string
                - 'null'
            country_code:
              type:
                - string
                - 'null'
            country_flag:
              type:
                - string
                - 'null'
          additionalProperties: true
        scores:
          type: object
          properties:
            home_score:
              type:
                - string
                - integer
                - 'null'
            away_score:
              type:
                - string
                - integer
                - 'null'
            ht_score:
              type:
                - string
                - 'null'
            ft_score:
              type:
                - string
                - 'null'
            et_score:
              type:
                - string
                - 'null'
            ps_score:
              type:
                - string
                - 'null'
          additionalProperties: true
        standings:
          type:
            - object
            - 'null'
          properties:
            home_position:
              type:
                - integer
                - 'null'
            away_position:
              type:
                - integer
                - 'null'
          additionalProperties: true
        assistants:
          type:
            - object
            - 'null'
          additionalProperties: true
        coverage:
          type:
            - object
            - 'null'
          properties:
            has_lineups:
              type:
                - integer
                - boolean
                - 'null'
            has_tvs:
              type:
                - integer
                - boolean
                - 'null'
            has_standings:
              type:
                - integer
                - boolean
                - 'null'
          additionalProperties: true
        weather_report:
          type:
            - object
            - 'null'
          additionalProperties: true
        events:
          type: array
          description: Present when `include` contains `events`; may be empty.
          items:
            $ref: '#/components/schemas/MatchEvent'
        stats:
          type: array
          description: Present when `include` contains `stats`; normally one item per team.
          items:
            $ref: '#/components/schemas/MatchStatistic'
        broadcast:
          type:
            - array
            - 'null'
          description: 'Present when `include` contains `broadcast`: TV channels showing the match.'
          items:
            $ref: '#/components/schemas/TvChannel'
        tvs:
          type: array
          description: Present on `broadcast?t=schedule` with `include=tvs`.
          items:
            $ref: '#/components/schemas/TvChannel'
        odds_prematch:
          type:
            - array
            - 'null'
          description: Present when `include` contains `odds_prematch`.
          items:
            $ref: '#/components/schemas/OddsMarket'
        odds_inplay:
          type:
            - array
            - 'null'
          description: Present when `include` contains `odds_inplay`.
          items:
            $ref: '#/components/schemas/OddsMarket'
      additionalProperties: true
    TvChannel:
      type: object
      description: TV channel or streaming service.
      properties:
        id:
          $ref: '#/components/schemas/FlexibleId'
        name:
          type: string
        type:
          type:
            - string
            - 'null'
          description: Channel type label, for example `Tv / Cable / Satellite`.
        img:
          type:
            - string
            - 'null'
          description: Logo URL, available in 100, 80, 50 and 18 px sizes.
        channel_url:
          type:
            - string
            - 'null'
        country:
          type:
            - object
            - 'null'
          properties:
            id:
              $ref: '#/components/schemas/NullableFlexibleId'
            name:
              type:
                - string
                - 'null'
            cc:
              type:
                - string
                - 'null'
          additionalProperties: true
      additionalProperties: true
    TvChannelListResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/TvChannel'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
    TvChannelDetailResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          $ref: '#/components/schemas/TvChannel'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
    OddsValues:
      type: object
      description: Odds of one bookmaker for one market. Prices are strings in the format selected with `odds_format`.
      properties:
        home:
          type:
            - string
            - 'null'
        draw:
          type:
            - string
            - 'null'
        away:
          type:
            - string
            - 'null'
        handicap:
          type:
            - string
            - number
            - 'null'
        score:
          type:
            - string
            - 'null'
        minute:
          type:
            - string
            - integer
            - 'null'
        bookmaker_event_id:
          type:
            - string
            - integer
            - 'null'
        last_update:
          type:
            - object
            - 'null'
          properties:
            date:
              type: string
            timezone:
              type: string
          additionalProperties: true
      additionalProperties: true
    OddsMarket:
      type: object
      description: One betting market with the odds of every bookmaker that prices it.
      properties:
        id:
          $ref: '#/components/schemas/FlexibleId'
        name:
          type: string
        bookmakers:
          type: array
          items:
            type: object
            properties:
              id:
                $ref: '#/components/schemas/FlexibleId'
              name:
                type: string
              odds:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/OddsValues'
                additionalProperties: true
            additionalProperties: true
      additionalProperties: true
    MatchOddsResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/OddsMarket'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
    StandingRecord:
      type: object
      properties:
        games_played:
          type: integer
        won:
          type: integer
        draw:
          type: integer
        lost:
          type: integer
        goals_diff:
          type: integer
        goals_scored:
          type: integer
        goals_against:
          type: integer
        points:
          type: integer
        position:
          type: integer
      additionalProperties: true
    StandingRow:
      type: object
      properties:
        team_id:
          $ref: '#/components/schemas/FlexibleId'
        team_name:
          type: string
        group:
          type:
            - string
            - 'null'
        group_name:
          type:
            - string
            - 'null'
        overall:
          $ref: '#/components/schemas/StandingRecord'
        home:
          $ref: '#/components/schemas/StandingRecord'
        away:
          $ref: '#/components/schemas/StandingRecord'
        total:
          type:
            - integer
            - 'null'
        status:
          type:
            - string
            - 'null'
          description: Zone label such as `Promotion` or `Relegation`.
        result:
          type:
            - string
            - 'null'
          description: Qualification outcome such as `Champions League`.
        points:
          type:
            - integer
            - 'null'
        recent_form:
          type:
            - string
            - 'null'
          description: Last results, newest last, for example `WWDLW`.
      additionalProperties: true
    StandingsResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          type: object
          properties:
            league_id:
              $ref: '#/components/schemas/FlexibleId'
            season_id:
              $ref: '#/components/schemas/FlexibleId'
            has_groups:
              type:
                - integer
                - boolean
            number_standings:
              type: integer
              description: Number of tables in the competition; each row carries its `group`.
            standings:
              type: array
              items:
                $ref: '#/components/schemas/StandingRow'
          additionalProperties: true
        meta:
          $ref: '#/components/schemas/ResponseMeta'
    LineupPlayer:
      type: object
      properties:
        player:
          type: object
          properties:
            id:
              $ref: '#/components/schemas/FlexibleId'
            name:
              type: string
            common_name:
              type:
                - string
                - 'null'
            firstname:
              type:
                - string
                - 'null'
            lastname:
              type:
                - string
                - 'null'
            img:
              type:
                - string
                - 'null'
            country:
              type:
                - object
                - 'null'
              additionalProperties: true
          additionalProperties: true
        number:
          type:
            - string
            - integer
            - 'null'
        captain:
          type:
            - boolean
            - integer
            - 'null'
        position:
          type:
            - string
            - 'null'
          description: 'Position group: `G`, `D`, `M` or `A`.'
        position_name:
          type:
            - string
            - 'null'
        order:
          type:
            - integer
            - 'null'
        stats:
          type:
            - object
            - 'null'
          description: Per-player statistics when `include=stats` is requested.
          additionalProperties: true
      additionalProperties: true
    LineupsResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          type: object
          properties:
            home:
              $ref: '#/components/schemas/LineupSide'
            away:
              $ref: '#/components/schemas/LineupSide'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
    LineupSide:
      type: object
      properties:
        formation:
          type:
            - string
            - 'null'
          description: For example `4-3-3`.
        confirmed_formation:
          type:
            - string
            - integer
            - 'null'
        squad:
          type: array
          items:
            $ref: '#/components/schemas/LineupPlayer'
      additionalProperties: true
    ResponseMeta:
      type: object
      description: Request allowance and pagination metadata present on every successful envelope.
      properties:
        requests_left:
          type: integer
          description: Requests left in the current allowance window.
        user:
          type: string
        plan:
          type: string
          description: Plan name of the account.
        page:
          type:
            - integer
            - string
            - 'null'
        pages:
          type:
            - integer
            - 'null'
          description: Number of pages; `1` on operations that are not paginated.
        count:
          type:
            - integer
            - 'null'
          description: Items in this page. Search reports `0`.
        total:
          type:
            - integer
            - 'null'
          description: Items across all pages. Search reports `0`.
        msg:
          type:
            - string
            - 'null'
          description: Empty on success; the error reason on `400` and unknown-resource `404`.
      additionalProperties: true
    FlexibleId:
      description: |-
        Resource identifier. Some operations serialize IDs as JSON numbers and
        others as numeric strings; clients should treat the value as opaque.
      oneOf:
        - type: integer
        - type: string
    NullableFlexibleId:
      oneOf:
        - $ref: '#/components/schemas/FlexibleId'
        - type: 'null'
    NullableMinute:
      oneOf:
        - type: integer
        - type: string
        - type: 'null'
    MatchEvent:
      type: object
      description: |-
        One event in a match timeline. Fields are nullable because coverage and
        source attribution vary. For a goal, `player_*` identifies the scorer
        and `related_player_*` identifies the assist provider when supplied.
        Names can be available while the corresponding ID is still null.
      properties:
        team_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        type:
          type: string
          description: |-
            Normalized event type, for example `goal`, `yellowcard`, `redcard`,
            `substitution`, `corner`, `shot_on_target` or `shot_off_target`.
        period:
          type:
            - string
            - 'null'
          examples:
            - 1st half
            - 2nd half
        player_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        player_name:
          type:
            - string
            - 'null'
          description: Scorer for a goal; primary player for other event types.
        related_player_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        related_player_name:
          type:
            - string
            - 'null'
          description: Assist provider for a goal when supplied by the source.
        minute:
          $ref: '#/components/schemas/NullableMinute'
        extra_minute:
          $ref: '#/components/schemas/NullableMinute'
        timestamp:
          description: Higher-precision event time when supplied; otherwise null.
          oneOf:
            - type: integer
            - type: string
            - type: 'null'
        reason:
          type:
            - string
            - 'null'
        injuried:
          description: Injury flag supplied by the API. The wire name is intentionally `injuried`.
          oneOf:
            - type: boolean
            - type: string
            - type: 'null'
        own_goal:
          type:
            - boolean
            - 'null'
        penalty:
          type:
            - boolean
            - 'null'
        result:
          type:
            - string
            - 'null'
          description: Score/result context when the source supplies it.
        info:
          type:
            - string
            - 'null'
          description: Human-readable context, such as the assist attribution.
      additionalProperties: true
      examples:
        - team_id: 20
          type: goal
          period: 1st half
          player_id: 311
          player_name: Neto
          related_player_id: 99608
          related_player_name: Rogers
          minute: '14'
          extra_minute: null
          timestamp: null
          reason: null
          injuried: null
          own_goal: false
          penalty: false
          result: null
          info: 'Assist by: Rogers'
    MatchStatistic:
      type: object
      description: Team statistics for one match. Metric availability varies by coverage.
      properties:
        team_id:
          $ref: '#/components/schemas/NullableFlexibleId'
        key_passes:
          type:
            - integer
            - number
            - string
            - 'null'
        passing_accuracy:
          type:
            - integer
            - number
            - string
            - 'null'
        fouls:
          type:
            - integer
            - number
            - string
            - 'null'
        corners:
          type:
            - integer
            - number
            - string
            - 'null'
        shots_total:
          type:
            - integer
            - number
            - string
            - 'null'
        shots_on_target:
          type:
            - integer
            - number
            - string
            - 'null'
        shots_off_target:
          type:
            - integer
            - number
            - string
            - 'null'
        possessionpercent:
          type:
            - integer
            - number
            - string
            - 'null'
        goals:
          type:
            - integer
            - number
            - string
            - 'null'
        xg:
          type:
            - integer
            - number
            - string
            - 'null'
      additionalProperties: true
    MatchListResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Match'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
    MatchDetailResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          $ref: '#/components/schemas/Match'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
    MatchEventsResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/MatchEvent'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
    MatchStatsResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/MatchStatistic'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
  securitySchemes: {}
security: []
