flashscore_openapi.yaml

openapi: 3.0.3
info:
  title: Live Sports Data API
  version: 1.0.0
  description: |
    OpenAPI specification for live sports data endpoints that normalize feed
    payloads, expose navigation and tournament resources, and proxy select
    upstream content such as search, news, odds, and images.
servers:
- url: http://localhost:8080
  description: Local development server
paths:
  /api/livescores/feed/{version}/{feed}:
    get:
      summary: Get feed data
      operationId: livescoresFeed
      description: 'Fetches feed data and normalizes the response into
        JSON.

        Response includes decoded field names in `header` and `records[].fields`.

        Field values are either strings or arrays when list-style values are present.'
      tags:
      - Feed
      parameters:
      - name: version
        in: path
        required: true
        description: 'Feed version identifier. Example: 2.'
        example: "2"
        schema:
          type: string
      - name: feed
        in: path
        required: true
        description: 'Feed name. Example: f_1_0_2_en_1.'
        example: f_1_0_2_en_1
        schema:
          type: string
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/sports/{sportId}/scoreboard:
    get:
      summary: Get sport scoreboard
      operationId: livescoresSportsScoreboard
      description: Fetches the full scoreboard feed for a sport and day offset.
      tags:
      - Feed
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 1.'
        example: 1
        schema:
          type: integer
      - name: dayOffset
        in: query
        required: false
        description: 'Day offset relative to today. Example: 0.'
        example: 0
        schema:
          type: integer
          default: 0
      - name: lang
        in: query
        required: false
        description: 'Language code. Example: en.'
        example: en
        schema:
          type: string
          default: en
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/sports/{sportId}/refresh:
    get:
      summary: Get sport refresh updates
      operationId: livescoresSportsRefresh
      description: Fetches lightweight refresh updates for a sport.
      tags:
      - Feed
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 1.'
        example: 1
        schema:
          type: integer
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/sports/{sportId}/odds:
    get:
      summary: Get sport odds list
      operationId: livescoresSportsOdds
      description: Fetches the odds list feed for a sport and day offset.
      tags:
      - Odds
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 1.'
        example: 1
        schema:
          type: integer
      - name: dayOffset
        in: query
        required: false
        description: 'Day offset relative to today. Example: 0.'
        example: 0
        schema:
          type: integer
          default: 0
      - name: lang
        in: query
        required: false
        description: 'Language code. Example: en.'
        example: en
        schema:
          type: string
          default: en
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/sports/{sportId}/featured:
    get:
      summary: Get sport featured list
      operationId: livescoresSportsFeatured
      description: Fetches featured matches for a sport.
      tags:
      - Feed
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 31.'
        example: 31
        schema:
          type: integer
      - name: scope
        in: query
        required: false
        description: 'Scope selector. Example: 0.'
        example: 0
        schema:
          type: integer
          default: 0
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      - name: lang
        in: query
        required: false
        description: 'Language code. Example: en.'
        example: en
        schema:
          type: string
          default: en
      - name: group
        in: query
        required: false
        description: 'Group selector. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/req/{req}:
    get:
      summary: Get navigation data
      operationId: livescoresReq
      description: 'Fetches navigation data from /x/req/{req}.

        Requests prefixed with `m_` are normalized into JSON; others are proxied as-is.'
      tags:
      - Navigation
      parameters:
      - name: req
        in: path
        required: true
        description: 'Req identifier. Example: m_1_17.'
        example: m_1_17
        schema:
          type: string
      responses:
        '200':
          description: Normalized req response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReqResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/navigation/{sportId}/{countryId}:
    get:
      summary: Get navigation by sport/country
      operationId: livescoresNavigation
      description: Fetches navigation data for a sport and country.
      tags:
      - Navigation
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 1.'
        example: 1
        schema:
          type: integer
      - name: countryId
        in: path
        required: true
        description: 'Country id. Example: 17.'
        example: 17
        schema:
          type: integer
      responses:
        '200':
          description: Normalized req response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReqResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/sports/{sportId}/categories:
    get:
      summary: Get sport categories
      operationId: livescoresSportsCategories
      description: 'Fetches category sections embedded in the sport landing page.

        Use `path` to override the sport URL path (e.g. motorsport/auto-racing).'
      tags:
      - Navigation
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 3.'
        example: 32
        schema:
          type: integer
      - name: path
        in: query
        required: false
        description: 'Override sport path. Example: motorsport/auto-racing.'
        example: auto-racing
        schema:
          type: string
      responses:
        '200':
          description: Category sections and items.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CategoriesResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/sports/{sportId}/categories/{categoryId}/tournaments:
    get:
      summary: Get category tournament list
      operationId: livescoresSportsCategoriesTournaments
      description: Fetches tournament list data for a sport category feed.
      tags:
      - Tournaments
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 1.'
        example: 1
        schema:
          type: integer
      - name: categoryId
        in: path
        required: true
        description: 'Category id. Example: 98.'
        example: 98
        schema:
          type: integer
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      - name: lang
        in: query
        required: false
        description: 'Language code. Example: en.'
        example: en
        schema:
          type: string
          default: en
      - name: flag
        in: query
        required: false
        description: 'Category flag (y/n). Example: y.'
        example: y
        schema:
          type: string
          default: y
          enum:
          - y
          - n
      - name: group
        in: query
        required: false
        description: 'Group selector. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/sports/{sportId}/season-calendar:
    get:
      summary: Get season calendar
      operationId: livescoresSportsSeasonCalendar
      description: Fetches season calendar data via persisted queries.
      tags:
      - Calendar
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 2.'
        example: 2
        schema:
          type: integer
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Season calendar payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/{sportId}/{categoryId}/{templateId}/matches:
    get:
      summary: Get tournament matches
      operationId: livescoresTournamentsMatches
      description: Fetches the match list for a tournament template.
      tags:
      - Tournaments
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 1.'
        example: 1
        schema:
          type: integer
      - name: categoryId
        in: path
        required: true
        description: 'Category id. Example: 98.'
        example: 98
        schema:
          type: integer
      - name: templateId
        in: path
        required: true
        description: 'Tournament template id. Example: COuk57Ci.'
        example: COuk57Ci
        schema:
          type: string
      - name: lang
        in: query
        required: false
        description: 'Language code. Example: en.'
        example: en
        schema:
          type: string
          default: en
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/{sportId}/{categoryId}/{templateId}/fixtures:
    get:
      summary: Get tournament fixtures
      operationId: livescoresTournamentsFixtures
      description: Fetches fixtures for a tournament template and round.
      tags:
      - Tournaments
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 1.'
        example: 1
        schema:
          type: integer
      - name: categoryId
        in: path
        required: true
        description: 'Category id. Example: 98.'
        example: 98
        schema:
          type: integer
      - name: templateId
        in: path
        required: true
        description: 'Tournament template id. Example: COuk57Ci.'
        example: COuk57Ci
        schema:
          type: string
      - name: round
        in: query
        required: true
        description: 'Round/segment identifier. Example: 187.'
        example: 187
        schema:
          type: integer
      - name: page
        in: query
        required: false
        description: 'Page number. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: lang
        in: query
        required: false
        description: 'Language code. Example: en.'
        example: en
        schema:
          type: string
          default: en
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/{sportId}/{categoryId}/{templateId}/results:
    get:
      summary: Get tournament results
      operationId: livescoresTournamentsResults
      description: Fetches results for a tournament template.
      tags:
      - Tournaments
      parameters:
      - name: sportId
        in: path
        required: true
        description: 'Sport id. Example: 2.'
        example: 2
        schema:
          type: integer
      - name: categoryId
        in: path
        required: true
        description: 'Category id. Example: 182.'
        example: 182
        schema:
          type: integer
      - name: templateId
        in: path
        required: true
        description: 'Tournament template id. Example: GrsQDFC0.'
        example: GrsQDFC0
        schema:
          type: string
      - name: segment
        in: query
        required: false
        description: 'Segment/round selector. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      - name: lang
        in: query
        required: false
        description: 'Language code. Example: en.'
        example: en
        schema:
          type: string
          default: en
      - name: page
        in: query
        required: false
        description: 'Page number. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: group
        in: query
        required: false
        description: 'Group/type selector. Example: s.'
        example: s
        schema:
          type: string
          default: s
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/{tournamentId}/top-scorers/{stageId}:
    get:
      summary: Get tournament top scorers
      operationId: livescoresTournamentsTopScorers
      description: Fetches top scorers for a tournament stage.
      tags:
      - Tournaments
      parameters:
      - name: tournamentId
        in: path
        required: true
        description: 'Tournament id. Example: 8recE9FQ.'
        example: 8recE9FQ
        schema:
          type: string
      - name: stageId
        in: path
        required: true
        description: 'Stage id. Example: EeBEiuQ0.'
        example: EeBEiuQ0
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/{tournamentId}/seasons/{stageId}:
    get:
      summary: Get tournament seasons
      operationId: livescoresTournamentsSeasons
      description: Fetches tournament seasons via persisted queries.
      tags:
      - Tournaments
      parameters:
      - name: tournamentId
        in: path
        required: true
        description: 'Tournament id. Example: UFxNEUzj.'
        example: UFxNEUzj
        schema:
          type: string
      - name: stageId
        in: path
        required: true
        description: 'Stage id. Example: vFA41USe.'
        example: vFA41USe
        schema:
          type: string
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Tournament seasons payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/resolve:
    get:
      summary: Resolve tournament metadata
      operationId: livescoresTournamentsResolve
      description: Extracts ids and season list from a tournament page.
      tags:
      - Tournaments
      parameters:
      - name: path
        in: query
        required: false
        description: 'Tournament path. Example: football/england/premier-league.'
        example: football/england/premier-league
        schema:
          type: string
      - name: sport
        in: query
        required: false
        description: 'Sport slug. Example: football.'
        example: football
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: 'Country slug. Example: england.'
        example: england
        schema:
          type: string
      - name: slug
        in: query
        required: false
        description: 'Tournament slug. Example: premier-league.'
        example: premier-league
        schema:
          type: string
      responses:
        '200':
          description: Tournament ids and season list.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TournamentResolveResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/archive:
    get:
      summary: Get tournament archive
      operationId: livescoresTournamentsArchive
      description: Fetches archive seasons and winners from a tournament archive page.
      tags:
      - Tournaments
      parameters:
      - name: path
        in: query
        required: false
        description: 'Tournament path. Example: football/england/premier-league.'
        example: football/england/premier-league
        schema:
          type: string
      - name: sport
        in: query
        required: false
        description: 'Sport slug. Example: football.'
        example: football
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: 'Country slug. Example: england.'
        example: england
        schema:
          type: string
      - name: slug
        in: query
        required: false
        description: 'Tournament slug. Example: premier-league.'
        example: premier-league
        schema:
          type: string
      responses:
        '200':
          description: Archive seasons and winners.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TournamentArchiveResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/participants/{participantId}/matches:
    get:
      summary: Get participant matches
      operationId: livescoresParticipantsMatches
      description: Fetches the match list for a participant (team or player).
      tags:
      - Participants
      parameters:
      - name: participantId
        in: path
        required: true
        description: 'Participant id. Example: 69Dxbc61.'
        example: 69Dxbc61
        schema:
          type: string
      - name: sportId
        in: query
        required: true
        description: 'Sport id. Example: 1.'
        example: 1
        schema:
          type: integer
      - name: categoryId
        in: query
        required: true
        description: 'Category id. Example: 98.'
        example: 98
        schema:
          type: integer
      - name: lang
        in: query
        required: false
        description: 'Language code. Example: en.'
        example: en
        schema:
          type: string
          default: en
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/participants/{participantId}/squad:
    get:
      summary: Get participant squad
      operationId: livescoresParticipantsSquad
      description: Extracts squad tables from a participant (team) page.
      tags:
      - Participants
      parameters:
      - name: participantId
        in: path
        required: true
        description: 'Participant id. Example: lId4TMwf.'
        example: lId4TMwf
        schema:
          type: string
      - name: path
        in: query
        required: false
        description: 'Team path. Example: team/liverpool/lId4TMwf.'
        example: team/liverpool/lId4TMwf
        schema:
          type: string
      - name: slug
        in: query
        required: false
        description: 'Team slug when path is omitted. Example: liverpool.'
        example: liverpool
        schema:
          type: string
      responses:
        '200':
          description: Squad tables grouped by section.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ParticipantSquadResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/participants/{participantId}/news:
    get:
      summary: Get participant news
      operationId: livescoresParticipantsNews
      description: Fetches news for a participant (team or player).
      tags:
      - Participants
      parameters:
      - name: participantId
        in: path
        required: true
        description: 'Participant id. Example: 69Dxbc61.'
        example: 69Dxbc61
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/participants/{participantId}/transfers:
    get:
      summary: Get participant transfers
      operationId: livescoresParticipantsTransfers
      description: Fetches transfer activity for a participant.
      tags:
      - Participants
      parameters:
      - name: participantId
        in: path
        required: true
        description: 'Participant id. Example: 69Dxbc61.'
        example: 69Dxbc61
        schema:
          type: string
      - name: tab
        in: query
        required: false
        description: 'Tab selector. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: page
        in: query
        required: false
        description: 'Page number. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/participants/{participantId}/events:
    get:
      summary: Get participant events
      operationId: livescoresParticipantsEvents
      description: Fetches participant event schedules (used by motorsport/cycling).
      tags:
      - Participants
      parameters:
      - name: participantId
        in: path
        required: true
        description: 'Participant id. Example: roX4hli0.'
        example: roX4hli0
        schema:
          type: string
      - name: projectTypeId
        in: query
        required: false
        description: 'Project type id. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/participants/{participantId}/events/{eventId}/detail:
    get:
      summary: Get participant event detail
      operationId: livescoresParticipantsEventsDetail
      description: Fetches event detail data for a participant event.
      tags:
      - Participants
      parameters:
      - name: participantId
        in: path
        required: true
        description: 'Participant id. Example: zNO51Dz3.'
        example: zNO51Dz3
        schema:
          type: string
      - name: eventId
        in: path
        required: true
        description: 'Event id. Example: IBdwmTR0.'
        example: IBdwmTR0
        schema:
          type: string
      - name: projectTypeId
        in: query
        required: false
        description: 'Project type id. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/participants/{participantId}/last-matches:
    get:
      summary: Get participant last matches
      operationId: livescoresParticipantsLastMatches
      description: Fetches recent matches for a participant (JSON feed).
      tags:
      - Participants
      parameters:
      - name: participantId
        in: path
        required: true
        description: 'Participant id. Example: xAzIxa5n.'
        example: xAzIxa5n
        schema:
          type: string
      - name: scope
        in: query
        required: false
        description: 'Scope selector. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Participant last matches payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/players/{playerId}/profile:
    get:
      summary: Get player profile
      operationId: livescoresPlayersProfile
      description: Fetches player profile data.
      tags:
      - Players
      parameters:
      - name: playerId
        in: path
        required: true
        description: 'Player id. Example: roX4hli0.'
        example: roX4hli0
        schema:
          type: string
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/players/{playerId}/match-record:
    get:
      summary: Get player match record
      operationId: livescoresPlayersMatchRecord
      description: Extracts match record tables from a player page (tennis).
      tags:
      - Players
      parameters:
      - name: playerId
        in: path
        required: true
        description: 'Player id. Example: UkhgIFEq.'
        example: UkhgIFEq
        schema:
          type: string
      - name: path
        in: query
        required: false
        description: 'Player path. Example: player/alcaraz-garfia-carlos/UkhgIFEq.'
        example: player/alcaraz-garfia-carlos/UkhgIFEq
        schema:
          type: string
      - name: slug
        in: query
        required: false
        description: 'Player slug when path is omitted. Example: alcaraz-garfia-carlos.'
        example: alcaraz-garfia-carlos
        schema:
          type: string
      responses:
        '200':
          description: Match record tables.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlayerMatchRecordResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/players/{playerId}/tournaments-won:
    get:
      summary: Get player tournaments won
      operationId: livescoresPlayersTournamentsWon
      description: Extracts tournaments won tables from a player page (tennis).
      tags:
      - Players
      parameters:
      - name: playerId
        in: path
        required: true
        description: 'Player id. Example: UkhgIFEq.'
        example: UkhgIFEq
        schema:
          type: string
      - name: path
        in: query
        required: false
        description: 'Player path. Example: player/alcaraz-garfia-carlos/UkhgIFEq.'
        example: player/alcaraz-garfia-carlos/UkhgIFEq
        schema:
          type: string
      - name: slug
        in: query
        required: false
        description: 'Player slug when path is omitted. Example: alcaraz-garfia-carlos.'
        example: alcaraz-garfia-carlos
        schema:
          type: string
      responses:
        '200':
          description: Tournaments won tables.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlayerTournamentsWonResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/players/{playerId}/injuries:
    get:
      summary: Get player injuries
      operationId: livescoresPlayersInjuries
      description: Extracts injury history from a player page.
      tags:
      - Players
      parameters:
      - name: playerId
        in: path
        required: true
        description: 'Player id. Example: UkhgIFEq.'
        example: UkhgIFEq
        schema:
          type: string
      - name: path
        in: query
        required: false
        description: 'Player path. Example: player/alcaraz-garfia-carlos/UkhgIFEq.'
        example: player/alcaraz-garfia-carlos/UkhgIFEq
        schema:
          type: string
      - name: slug
        in: query
        required: false
        description: 'Player slug when path is omitted. Example: alcaraz-garfia-carlos.'
        example: alcaraz-garfia-carlos
        schema:
          type: string
      responses:
        '200':
          description: Player injury history.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlayerInjuriesResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/rankings/resolve:
    get:
      summary: Resolve ranking id
      operationId: livescoresRankingsResolve
      description: Fetches a rankings page and extracts the rankingId.
      tags:
      - Rankings
      parameters:
      - name: path
        in: query
        required: false
        description: 'Ranking page path. Example: tennis/rankings/atp.'
        example: tennis/rankings/atp
        schema:
          type: string
      - name: sport
        in: query
        required: false
        description: 'Sport slug. Example: tennis.'
        example: tennis
        schema:
          type: string
      - name: slug
        in: query
        required: false
        description: 'Ranking slug. Example: atp.'
        example: atp
        schema:
          type: string
      responses:
        '200':
          description: Resolved ranking id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RankingIDResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/rankings/{sport}/{slug}/id:
    get:
      summary: Resolve ranking id by slug
      operationId: livescoresRankingsId
      description: Fetches a rankings page and extracts the rankingId.
      tags:
      - Rankings
      parameters:
      - name: sport
        in: path
        required: true
        description: 'Sport slug. Example: tennis.'
        example: tennis
        schema:
          type: string
      - name: slug
        in: path
        required: true
        description: 'Ranking slug. Example: atp.'
        example: atp
        schema:
          type: string
      responses:
        '200':
          description: Resolved ranking id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RankingIDResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/rankings/{rankingId}:
    get:
      summary: Get rankings
      operationId: livescoresRankings
      description: Fetches ranking tables.
      tags:
      - Rankings
      parameters:
      - name: rankingId
        in: path
        required: true
        description: 'Ranking id. Example: 4KeVObqb.'
        example: 4KeVObqb
        schema:
          type: string
      - name: tab
        in: query
        required: false
        description: 'Tab selector. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 1
      - name: variant
        in: query
        required: false
        description: 'Variant: ran or ral.'
        schema:
          type: string
          default: ran
          enum:
          - ran
          - ral
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/hashes:
    get:
      summary: Get match hash feed
      operationId: livescoresMatchesHashes
      description: Fetches the hash feed for a match (used by incremental updates).
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/stats:
    get:
      summary: Get match stats
      operationId: livescoresMatchesStats
      description: Fetches stats for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/timeline:
    get:
      summary: Get match timeline
      operationId: livescoresMatchesTimeline
      description: Fetches timeline/incidents for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/commentary:
    get:
      summary: Get match commentary
      operationId: livescoresMatchesCommentary
      description: Fetches live commentary for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/commentary-only:
    get:
      summary: Get match commentary only
      operationId: livescoresMatchesCommentaryOnly
      description: Fetches commentary-only updates for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: MJ0y6sRk.'
        example: MJ0y6sRk
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/point-by-point:
    get:
      summary: Get match point-by-point
      operationId: livescoresMatchesPointByPoint
      description: Fetches point-by-point data for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: GWMzzSEk.'
        example: GWMzzSEk
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/h2h:
    get:
      summary: Get match head-to-head
      operationId: livescoresMatchesH2h
      description: Fetches head-to-head data for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/news:
    get:
      summary: Get match news
      operationId: livescoresMatchesNews
      description: Fetches news entries for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/news-layout:
    get:
      summary: Get match news layout
      operationId: livescoresMatchesNewsLayout
      description: Fetches match news layout data via persisted queries.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: MJ0y6sRk.'
        example: MJ0y6sRk
        schema:
          type: string
      - name: layoutTypeId
        in: query
        required: false
        description: 'Layout type id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Match news layout payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/report:
    get:
      summary: Get match report
      operationId: livescoresMatchesReport
      description: Fetches match report entries.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/tv/long:
    get:
      summary: Get match TV list (long)
      operationId: livescoresMatchesTvLong
      description: Fetches the full TV/broadcast list for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/tv/short:
    get:
      summary: Get match TV list (short)
      operationId: livescoresMatchesTvShort
      description: Fetches the short TV/broadcast list for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/odds-detail:
    get:
      summary: Get match odds detail
      operationId: livescoresMatchesOddsDetail
      description: Fetches odds details for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/highlights:
    get:
      summary: Get match highlights
      operationId: livescoresMatchesHighlights
      description: Fetches highlights for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/highlights/videos:
    get:
      summary: Get match highlight videos
      operationId: livescoresMatchesHighlightsVideos
      description: Fetches highlight video entries for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: vH0563UN.'
        example: vH0563UN
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/overview:
    get:
      summary: Get match overview
      operationId: livescoresMatchesOverview
      description: Fetches overview data for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: C8wD2fTk.'
        example: C8wD2fTk
        schema:
          type: string
      - name: tab
        in: query
        required: false
        description: 'Tab selector. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/top-scorers:
    get:
      summary: Get match top scorers
      operationId: livescoresMatchesTopScorers
      description: Fetches top scorers table for a match.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: MJ0y6sRk.'
        example: MJ0y6sRk
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/report/html:
    get:
      summary: Get match report (HTML)
      operationId: livescoresMatchesReportHtml
      description: Fetches the full match report HTML.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: vH0563UN.'
        example: vH0563UN
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Match report payload.
          content:
            text/html:
              schema:
                type: string
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/matches/{eventId}/detail-config:
    get:
      summary: Get match detail config
      operationId: livescoresMatchesDetailConfig
      description: Fetches the match detail configuration feed.
      tags:
      - Matches
      parameters:
      - name: eventId
        in: path
        required: true
        description: 'Match event id. Example: MJ0y6sRk.'
        example: MJ0y6sRk
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/{tournamentId}/tables/{stageId}:
    get:
      summary: Get tournament table
      operationId: livescoresTournamentsTables
      description: Fetches table data for a tournament stage.
      tags:
      - Tables
      parameters:
      - name: tournamentId
        in: path
        required: true
        description: 'Tournament id. Example: M1c7lv64.'
        example: M1c7lv64
        schema:
          type: string
      - name: stageId
        in: path
        required: true
        description: 'Stage id. Example: tKE3WZmL.'
        example: tKE3WZmL
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/{tournamentId}/overview/{stageId}:
    get:
      summary: Get tournament overview
      operationId: livescoresTournamentsOverview
      description: Fetches tournament overview data for a stage.
      tags:
      - Tournaments
      parameters:
      - name: tournamentId
        in: path
        required: true
        description: 'Tournament id. Example: 8recE9FQ.'
        example: 8recE9FQ
        schema:
          type: string
      - name: stageId
        in: path
        required: true
        description: 'Stage id. Example: dK0Jjau7.'
        example: dK0Jjau7
        schema:
          type: string
      - name: tab
        in: query
        required: false
        description: 'Tab selector. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/{tournamentId}/list/{stageId}:
    get:
      summary: Get tournament list
      operationId: livescoresTournamentsList
      description: Fetches tournament list data for a stage.
      tags:
      - Tournaments
      parameters:
      - name: tournamentId
        in: path
        required: true
        description: 'Tournament id. Example: 04lKZTBr.'
        example: 04lKZTBr
        schema:
          type: string
      - name: stageId
        in: path
        required: true
        description: 'Stage id. Example: 6PWwAsA7.'
        example: 6PWwAsA7
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/tournaments/{tournamentId}/draw/{stageId}:
    get:
      summary: Get tournament draw
      operationId: livescoresTournamentsDraw
      description: Fetches tournament draw data for a stage.
      tags:
      - Tournaments
      parameters:
      - name: tournamentId
        in: path
        required: true
        description: 'Tournament id. Example: UFxNEUzj.'
        example: UFxNEUzj
        schema:
          type: string
      - name: stageId
        in: path
        required: true
        description: 'Stage id. Example: vFA41USe.'
        example: vFA41USe
        schema:
          type: string
      - name: groupId
        in: query
        required: false
        description: 'Optional group id. Example: QRiI3vYF.'
        example: QRiI3vYF
        schema:
          type: string
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/graphql:
    get:
      summary: Get persisted GraphQL data
      operationId: livescoresGraphql
      description: 'Proxies persisted-query requests to the upstream GraphQL endpoint and returns the raw JSON payload.

        Pass required query params such as `_hash`, `eventId`, and `projectId`.'
      tags:
      - GraphQL
      parameters:
      - name: _hash
        in: query
        required: true
        description: 'Persisted query hash. Example: dmpe2.'
        example: dmpe2
        schema:
          type: string
      - name: eventId
        in: query
        required: false
        description: 'Event id for match-specific queries. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: projectId
        in: query
        required: false
        description: 'Project id for the persisted query. Example: 1.'
        example: 1
        schema:
          type: integer
      responses:
        '200':
          description: GraphQL response payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/odds:
    get:
      summary: Get odds GraphQL data
      operationId: livescoresOdds
      description: 'Proxies persisted-query requests to the upstream odds GraphQL endpoint
        and returns the raw JSON payload.

        Pass required query params such as `_hash`, `eventId`, and `projectId`.'
      tags:
      - Odds
      parameters:
      - name: _hash
        in: query
        required: true
        description: 'Persisted query hash. Example: oce.'
        example: oce
        schema:
          type: string
      - name: eventId
        in: query
        required: false
        description: 'Event id for match-specific odds queries. Example: 08W6fzLP.'
        example: 08W6fzLP
        schema:
          type: string
      - name: projectId
        in: query
        required: false
        description: 'Project id for the persisted query. Example: 1.'
        example: 1
        schema:
          type: integer
      responses:
        '200':
          description: Odds response payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/search:
    get:
      summary: Search entities
      operationId: livescoresSearch
      description: Proxies the upstream search endpoint for teams, players, tournaments,
        and more, returning the raw results payload.
      tags:
      - Search
      parameters:
      - name: q
        in: query
        required: true
        description: Search query string.
        schema:
          type: string
      responses:
        '200':
          description: Search results payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/top-search:
    get:
      summary: Top search suggestions
      operationId: livescoresTopSearch
      description: Proxies the upstream top-search suggestions endpoint.
      tags:
      - Search
      responses:
        '200':
          description: Top search payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/news:
    get:
      summary: Get news list
      operationId: livescoresNews
      description: 'Fetches the news list feed and normalizes it into header and
        record entries.

        Use `sectionId` (or `categoryId`) to select a news section.'
      tags:
      - News
      parameters:
      - name: sportId
        in: query
        required: true
        description: 'Sport id. Example: 1.'
        example: 1
        schema:
          type: integer
      - name: sectionId
        in: query
        required: true
        description: 'News section id. Example: 59.'
        example: 59
        schema:
          type: integer
      - name: categoryId
        in: query
        required: false
        description: Alias for sectionId.
        schema:
          type: integer
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/news/articles/{articleId}:
    get:
      summary: Get news article
      operationId: livescoresNewsArticles
      description: Fetches news article content via persisted queries.
      tags:
      - News
      parameters:
      - name: articleId
        in: path
        required: true
        description: 'Article id. Example: v3LmzFnC.'
        example: v3LmzFnC
        schema:
          type: string
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: News article payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/news/entities/{entityTypeId}/{entityId}:
    get:
      summary: Get entity news list
      operationId: livescoresNewsEntities
      description: Fetches news layout entries for a team, tournament, or player via
        persisted queries.
      tags:
      - News
      parameters:
      - name: entityTypeId
        in: path
        required: true
        description: 'Entity type id. Example: 41.'
        example: 41
        schema:
          type: integer
      - name: entityId
        in: path
        required: true
        description: 'Entity id. Example: MP4jLdJh.'
        example: MP4jLdJh
        schema:
          type: string
      - name: layoutTypeId
        in: query
        required: false
        description: 'Layout type id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      - name: page
        in: query
        required: false
        description: 'Page number. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: perPage
        in: query
        required: false
        description: 'Items per page. Example: 10.'
        example: 10
        schema:
          type: integer
          default: 10
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Entity news layout payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/updates:
    get:
      summary: Get updates
      operationId: livescoresUpdates
      description: Fetches incremental update data for a sport.
      tags:
      - Updates
      parameters:
      - name: sportId
        in: query
        required: true
        description: 'Sport id. Example: 1.'
        example: 1
        schema:
          type: integer
      - name: scope
        in: query
        required: false
        description: 'Scope selector. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/updates/list:
    get:
      summary: Get updates list
      operationId: livescoresUpdatesList
      description: Fetches update list data for a sport.
      tags:
      - Updates
      parameters:
      - name: sportId
        in: query
        required: true
        description: 'Sport id. Example: 2.'
        example: 2
        schema:
          type: integer
      - name: scope
        in: query
        required: false
        description: 'Scope selector. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 1
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/updates/counts:
    get:
      summary: Get update counts
      operationId: livescoresUpdatesCounts
      description: Fetches match count data used by the update polling loop.
      tags:
      - Updates
      parameters:
      - name: projectId
        in: query
        required: false
        description: 'Project id. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/system/status:
    get:
      summary: Get system status
      operationId: livescoresSystemStatus
      description: Fetches system status data from the sys feed.
      tags:
      - System
      parameters:
      - name: scope
        in: query
        required: false
        description: 'Scope selector. Example: 1.'
        example: 1
        schema:
          type: integer
          default: 1
      - name: version
        in: query
        required: false
        description: 'Feed version. Example: 2.'
        example: 2
        schema:
          type: integer
          default: 2
      responses:
        '200':
          description: Normalized feed response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/banners:
    get:
      summary: Get banners
      operationId: livescoresBanners
      description: Proxies banner placement data used for site placements.
      tags:
      - Content
      responses:
        '200':
          description: Banner payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/remote-stats:
    get:
      summary: Get remote stats
      operationId: livescoresRemoteStats
      description: Proxies the upstream remote stats endpoint for supplemental statistics.
      tags:
      - Stats
      responses:
        '200':
          description: Remote stats payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JSONResult'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/images/static/{path}:
    get:
      summary: Get static asset image
      operationId: livescoresImagesStatic
      description: Fetches static assets such as bookmaker logos.
      tags:
      - Images
      parameters:
      - name: path
        in: path
        required: true
        description: 'Asset path. Example: res/image/data/bookmakers/80-915.png.'
        example: res/image/data/bookmakers/80-915.png
        schema:
          type: string
        allowReserved: true
        style: simple
        explode: false
      responses:
        '200':
          description: Image asset.
          content:
            image/png:
              schema:
                type: string
                format: binary
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /api/livescores/images/ott/{path}:
    get:
      summary: Get media image
      operationId: livescoresImagesOtt
      description: Fetches media images (news covers, photos, etc.).
      tags:
      - Images
      parameters:
      - name: path
        in: path
        required: true
        description: 'Image path. Example: r300xfq60/26bb49b4-4e3b-4899-9055-dc456da25e10.avif.'
        example: r300xfq60/26bb49b4-4e3b-4899-9055-dc456da25e10.avif
        schema:
          type: string
        allowReserved: true
        style: simple
        explode: false
      responses:
        '200':
          description: Media image.
          content:
            image/avif:
              schema:
                type: string
                format: binary
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: Upstream error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    FeedRecord:
      type: object
      description: Record entry containing decoded fields.
      properties:
        fields:
          type: object
          additionalProperties: true
    FeedResponse:
      type: object
      description: Normalized feed response.
      properties:
        version:
          type: string
        feed:
          type: string
        header:
          type: object
          additionalProperties: true
        records:
          type: array
          items:
            $ref: '#/components/schemas/FeedRecord'
    ReqResponse:
      type: object
      description: Normalized req response.
      properties:
        req:
          type: string
        header:
          type: object
          additionalProperties: true
        records:
          type: array
          items:
            $ref: '#/components/schemas/FeedRecord'
    CategoriesResponse:
      type: object
      properties:
        sportId:
          type: integer
        path:
          type: string
        sections:
          type: array
          items:
            $ref: '#/components/schemas/CategorySection'
    CategorySection:
      type: object
      properties:
        name:
          type: string
        url:
          type: string
        categories:
          type: array
          items:
            $ref: '#/components/schemas/CategoryItem'
    CategoryItem:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        url:
          type: string
        sportId:
          type: integer
    RankingIDResponse:
      type: object
      properties:
        path:
          type: string
        rankingId:
          type: string
        sport:
          type: string
        slug:
          type: string
        feeds:
          type: object
          additionalProperties:
            type: string
    TournamentArchiveResponse:
      type: object
      properties:
        path:
          type: string
        tournamentId:
          type: string
        stageId:
          type: string
        seasons:
          type: array
          items:
            $ref: '#/components/schemas/TournamentArchiveSeason'
    TournamentArchiveSeason:
      type: object
      properties:
        season:
          type: string
        seasonUrl:
          type: string
        winner:
          $ref: '#/components/schemas/TournamentArchiveWinner'
    TournamentArchiveWinner:
      type: object
      properties:
        name:
          type: string
        url:
          type: string
        id:
          type: string
        logo:
          type: string
    TournamentResolveResponse:
      type: object
      properties:
        path:
          type: string
        tournamentId:
          type: string
        stageId:
          type: string
        templateId:
          type: string
        sportId:
          type: integer
        selectedSeasonId:
          type: string
        seasons:
          type: array
          items:
            $ref: '#/components/schemas/TournamentSeason'
    TournamentSeason:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        path:
          type: string
    ParticipantSquadResponse:
      type: object
      properties:
        participantId:
          type: string
        slug:
          type: string
        path:
          type: string
        sections:
          type: array
          items:
            $ref: '#/components/schemas/SquadSection'
    SquadSection:
      type: object
      properties:
        name:
          type: string
        rows:
          type: array
          items:
            $ref: '#/components/schemas/SquadRow'
    SquadRow:
      type: object
      properties:
        cells:
          type: object
          additionalProperties:
            type: string
        player:
          $ref: '#/components/schemas/SquadPlayer'
    SquadPlayer:
      type: object
      properties:
        name:
          type: string
        id:
          type: string
        url:
          type: string
        country:
          type: string
        flagId:
          type: string
        absence:
          type: string
    PlayerMatchRecordResponse:
      type: object
      properties:
        playerId:
          type: string
        slug:
          type: string
        path:
          type: string
        tables:
          type: array
          items:
            $ref: '#/components/schemas/PlayerMatchRecordTable'
    PlayerMatchRecordTable:
      type: object
      properties:
        type:
          type: string
        records:
          type: array
          items:
            $ref: '#/components/schemas/PlayerMatchRecord'
    PlayerMatchRecord:
      type: object
      properties:
        season:
          type: string
        rank:
          type: string
        titles:
          type: string
        allMatches:
          type: string
        hard:
          type: string
        clay:
          type: string
        grass:
          type: string
    PlayerTournamentsWonResponse:
      type: object
      properties:
        playerId:
          type: string
        slug:
          type: string
        path:
          type: string
        tables:
          type: array
          items:
            $ref: '#/components/schemas/TournamentWinTable'
    TournamentWinTable:
      type: object
      properties:
        type:
          type: string
        years:
          type: array
          items:
            $ref: '#/components/schemas/TournamentWinYear'
    TournamentWinYear:
      type: object
      properties:
        year:
          type: string
        wins:
          type: array
          items:
            $ref: '#/components/schemas/TournamentWinEntry'
    TournamentWinEntry:
      type: object
      properties:
        tournament:
          type: string
        url:
          type: string
        country:
          type: string
        surface:
          type: string
        prizeMoney:
          type: string
    PlayerInjuriesResponse:
      type: object
      properties:
        playerId:
          type: string
        slug:
          type: string
        path:
          type: string
        injuries:
          type: array
          items:
            $ref: '#/components/schemas/PlayerInjury'
    PlayerInjury:
      type: object
      properties:
        from:
          type: string
        until:
          type: string
        name:
          type: string
        hidden:
          type: boolean
    JSONResult:
      type: object
      description: A generic JSON object response.
      additionalProperties: true
    APIError:
      type: object
      description: Problem details returned on errors.
      properties:
        status:
          type: integer
          description: The HTTP status code.
        title:
          type: string
          description: A short, human-readable summary of the error.
        request_id:
          type: string
          description: A unique identifier for the request.
    ErrorResponse:
      type: object
      description: Error envelope.
      properties:
        error:
          $ref: '#/components/schemas/APIError'
tags:
- name: Feed
  description: Feed and scoreboard endpoints.
- name: Odds
  description: Odds endpoints.
- name: Navigation
  description: Navigation and category endpoints.
- name: Tournaments
  description: Tournament endpoints.
- name: Calendar
  description: Calendar endpoints.
- name: Participants
  description: Participant (team/player) endpoints.
- name: Players
  description: Player endpoints.
- name: Rankings
  description: Ranking endpoints.
- name: Matches
  description: Match endpoints.
- name: Tables
  description: Table and standings endpoints.
- name: GraphQL
  description: Persisted query proxy endpoints.
- name: Search
  description: Search endpoints.
- name: News
  description: News endpoints.
- name: Updates
  description: Update polling endpoints.
- name: System
  description: System status endpoints.
- name: Content
  description: Content and banner endpoints.
- name: Stats
  description: Statistics endpoints.
- name: Images
  description: Image asset endpoints.