> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Lister les fixtures

> Événements (prématch, live, variantes). Filtrable ; `parent_id` renvoie les enfants d'un match.



## OpenAPI

````yaml /api-reference/openapi.json get /api/fixtures
openapi: 3.1.0
info:
  title: apinn — Pinnacle Data API
  version: 1.0.0
  description: Cotes Pinnacle en temps réel, format iso Pinnacle Data API.
servers:
  - url: https://api.apinn.io
security:
  - ApiKeyAuth: []
paths:
  /api/fixtures:
    get:
      summary: Lister les fixtures
      description: >-
        Événements (prématch, live, variantes). Filtrable ; `parent_id` renvoie
        les enfants d'un match.
      parameters:
        - name: event_id
          in: query
          schema:
            type: integer
        - name: sport_id
          in: query
          schema:
            type: integer
          example: 29
        - name: league_id
          in: query
          schema:
            type: integer
        - name: parent_id
          in: query
          description: >-
            Renvoie les enfants (live child, corners, bookings) d'un event
            prématch.
          schema:
            type: integer
        - name: live
          in: query
          description: 0 = prématch, 1 = live.
          schema:
            type: integer
            enum:
              - 0
              - 1
        - name: starts_from
          in: query
          schema:
            type: string
        - name: starts_to
          in: query
          schema:
            type: string
        - name: limit
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: Liste des fixtures
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Fixture'
              example:
                - timestamp: '2026-07-16T14:00:00'
                  sport_id: 29
                  sport_name: Soccer
                  league_id: 1835
                  league_name: Brazil - Serie B
                  event_id: 1632003656
                  starts: '2026-08-22T18:45:00'
                  runner_home: Genoa
                  runner_away: Napoli
                  live_status: 0
                  resulting_unit: Regular
                  parent_id: null
                  version: 674
components:
  schemas:
    Fixture:
      type: object
      properties:
        timestamp:
          type: string
        sport_id:
          type: integer
        sport_name:
          type: string
        league_id:
          type: integer
        league_name:
          type: string
        event_id:
          type: integer
        starts:
          type: string
          description: Coup d'envoi (ISO).
        runner_home:
          type:
            - string
            - 'null'
        runner_away:
          type:
            - string
            - 'null'
        live_status:
          type: integer
          description: 0 = prématch, 1 = live, 2 = terminé.
        resulting_unit:
          type: string
          description: '"Regular" = match principal ; sinon variante (Corners, Bookings…).'
        parent_id:
          type:
            - integer
            - 'null'
          description: Event parent (pour les enfants live / variantes).
        version:
          type:
            - integer
            - 'null'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````