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

# Catalogue des specials / outrights

> Une ligne par marché × contestant (props, futures) avec métadonnées, sans cotes.



## OpenAPI

````yaml /api-reference/openapi.json get /api/specials/outrights
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/specials/outrights:
    get:
      summary: Catalogue des specials / outrights
      description: >-
        Une ligne par marché × contestant (props, futures) avec métadonnées,
        sans cotes.
      parameters:
        - name: sport_id
          in: query
          required: true
          schema:
            type: integer
          example: 29
      responses:
        '200':
          description: Catalogue
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SpecialOutright'
              example:
                - sport_id: 29
                  league_id: 2627
                  special_id: 1631640230
                  bet_type: MULTI_WAY_HEAD_TO_HEAD
                  special_name: UEFA - Champions League Winner
                  starts: '2026-08-27T11:00:00'
                  cutoff: '2026-08-27T11:00:00'
                  category: Futures
                  units: null
                  event_id: null
                  period: null
                  runner_home: null
                  runner_away: null
                  contestant_id: 1631655298
                  contestant_name: AEK Athens
                  timestamp: '2026-07-16T13:15:28'
components:
  schemas:
    SpecialOutright:
      type: object
      properties:
        sport_id:
          type: integer
        league_id:
          type:
            - integer
            - 'null'
        special_id:
          type: integer
        bet_type:
          type: string
        special_name:
          type: string
        starts:
          type:
            - string
            - 'null'
        cutoff:
          type:
            - string
            - 'null'
        category:
          type: string
          description: Futures, Player Props, Specials…
        units:
          type:
            - string
            - 'null'
        event_id:
          type:
            - integer
            - 'null'
          description: null pour les futures de tournoi.
        period:
          type:
            - integer
            - 'null'
        runner_home:
          type:
            - string
            - 'null'
        runner_away:
          type:
            - string
            - 'null'
        contestant_id:
          type:
            - integer
            - 'null'
        contestant_name:
          type: string
        timestamp:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````