Skip to main content
GET
Lister les fixtures

Autorisations

X-API-Key
string
header
requis

Paramètres de requête

event_id
integer | null

Identifiant Pinnacle de l'événement. Look up a specific event

parent_id
integer | null

Ne renvoie que les enfants de cet événement (corners, cartons, mi-temps…). Find child fixtures of a prematch event: combine with live=1 for the live/in-play counterpart, or live=0 (default) for prematch children like Corners/Bookings

sport_id
integer | null

Identifiant du sport.

league_id
integer | null

Identifiant de la ligue.

starts_from
string | null

Début de la fenêtre de coup d envoi (UTC). YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (UTC). T separator and trailing Z accepted.

starts_to
string | null

Fin de la fenêtre de coup d envoi (UTC). YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (UTC). Date-only includes the entire day.

since
string | null

Ne renvoie que ce qui a changé après cet horodatage UTC. Only fixtures added/updated after this timestamp (ISO 8601)

live
integer
défaut:0

0 = à venir, 1 = en direct, 2 = terminé. true/false acceptés (= 1/0). Toute autre valeur → 422. 0 = prematch only (default), 1 = live/in-play only

closing_available
integer | null

1 = uniquement les events ayant une cote de clôture enregistrée. true/false acceptés. Toute autre valeur → 422. 1 = only fixtures with closing data

opening_available
integer | null

1 = uniquement les events ayant une cote d'ouverture enregistrée. true/false acceptés. Toute autre valeur → 422. 1 = only fixtures with opening data

limit
integer
défaut:100

Nombre maximum de lignes renvoyées. Max rows returned (default 100, hard cap 1000). When the result is truncated, the response carries an X-Truncated: true header. Only raise this if you really need more rows in a single call — and combine it with league_id, since, or a starts_from/starts_to window so the response stays small and fast.

Plage requise: x <= 1000

Réponse

200 - application/json

Liste des fixtures

timestamp
string
sport_id
integer
sport_name
string
league_id
integer
league_name
string
event_id
integer
starts
string

Coup d'envoi (ISO).

runner_home
string | null
runner_away
string | null
live_status
integer

0 = prématch, 1 = live, 2 = terminé.

resulting_unit
string

"Regular" = match principal ; sinon variante (Corners, Bookings…).

parent_id
integer | null

Event parent (pour les enfants live / variantes).

version
integer | null