> ## 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.

# Board — tous les matchs + cotes principales

> Un match par ligne avec ses cotes principales (moneyline/spread/totals) — permet d'afficher tout le board en une réponse, sans N appels /api/odds.



## OpenAPI

````yaml /api-reference/openapi.json get /api/board
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/board:
    get:
      summary: Board — tous les matchs + cotes principales
      description: >-
        Un match par ligne avec ses cotes principales (moneyline/spread/totals)
        — permet d'afficher tout le board en une réponse, sans N appels
        /api/odds.
      parameters:
        - name: sport_id
          in: query
          schema:
            type: integer
          example: 29
        - name: league_id
          in: query
          schema:
            type: integer
        - name: live
          in: query
          schema:
            type: integer
            enum:
              - 0
              - 1
        - name: with_odds
          in: query
          description: 1 = uniquement les matchs ayant des cotes.
          schema:
            type: integer
            enum:
              - 0
              - 1
        - name: limit
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: Board
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BoardRow'
              example:
                - timestamp: '2026-07-16T00:00:00'
                  sport_id: 29
                  sport_name: Soccer
                  league_id: 5598
                  league_name: Ecuador - Serie A
                  event_id: 1632549035
                  starts: '2026-07-15T22:00:00'
                  runner_home: Leones del Norte
                  runner_away: Deportivo Cuenca
                  live_status: 1
                  resulting_unit: Regular
                  parent_id: 1632412892
                  version: 675510750
                  odds:
                    moneyline:
                      line: null
                      odds1: 5.92
                      odds0: 1.159
                      odds2: 21.56
                      suspended: false
components:
  schemas:
    BoardRow:
      allOf:
        - $ref: '#/components/schemas/Fixture'
        - type: object
          properties:
            odds:
              type: object
              description: Cotes principales par marché.
              properties:
                moneyline:
                  $ref: '#/components/schemas/MainLine'
                spread:
                  $ref: '#/components/schemas/MainLine'
                totals:
                  $ref: '#/components/schemas/MainLine'
    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'
    MainLine:
      type: object
      properties:
        line:
          type:
            - number
            - 'null'
        odds1:
          type:
            - number
            - 'null'
        odds0:
          type:
            - number
            - 'null'
        odds2:
          type:
            - number
            - 'null'
        suspended:
          type: boolean
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````