Get fixtures with participants, scores and periods

Returns a list of fixtures with participants, scores and periods.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer

The ID of the sport. Defaults to 1.

string

Comma-separated list of league IDs.

string

Comma-separated list of specific fixture IDs.

integer

The ID of the season to filter fixtures by.

status
array of strings

Comma-separated list of fixture statuses to include.
When omitted, fixtures of any status are returned except DELETED — deleted fixtures are only returned when DELETED is named here explicitly.
👉 View State Definitions

status
string

Date in ISO 8601 YYYY-MM-DD format.

string

Localization code (default: en).

include
array of strings

Comma-separated list of modules to include. Example: include=odds,metrics. Note: Using an include unlocks the corresponding filter[entity] parameter.

integration attaches the bookmaker-integration mapping payload and is restricted to clients entitled to an integration — see filter[integration] and docs/integration.md.

squads is in beta — its shape and coverage may still change.

player_metrics must be requested together with squads (include=squads,player_metrics) — the metric rows identify players by player_id only, and squads carries their names and positions.

include
string
^[a-z_]+:[^;]+(;[a-z_]+:[^;]+)*$

Selects which integration answers, and filters by your platform's own ids.
Segments are separated by ;, values inside a segment by ,.

providers:<name> picks the integration. Only ONE per request: if several are listed, the
first is honoured and the rest ignored. The one that answered is named by provider inside
each fixture's integration object. Omitted, it defaults to the integration your API key is
entitled to. Naming an integration you are not entitled to returns 403; naming one that
does not exist returns 400.

Supported here:

  • ext_event_ids — your event ids. A superseded id from a republished event still resolves.
  • ext_league_ids — your league ids. One of yours can map to several of ours (a regionalised
    division is one league to you and several groups to us); every one of them is returned.
  • ext_master_league_ids — prefer this over ext_league_ids: it survives your id rotations.
  • ext_country_ids — every league we hold under that country of yours.
  • ext_team_ids — the team on either side; ext_home_ids / ext_away_ids pin the side.
  • One of the three league keys, and one of the three team keys, per request.
  • mapped_only:1 — restrict to fixtures your own feed carries. Your platform publishes an
    event roughly 2-3 days before kickoff, so a plain league filter over the default 7-day
    window returns many fixtures you do not have yet. Needs a league, country or team key.

Send ids exactly as you receive them in the integration object, as strings — they are
64-bit values that a JSON number cannot hold without corruption.

An id we have no mapping for is not an error: you get an empty list, never an unfiltered
one. Coverage grows as we see more of your events.

A key this endpoint does not support returns 400 rather than being ignored, and so does
naming the same thing twice — league_id with a league key, or fixture_id with
ext_event_ids.

string

Optional filter for the included player_metrics module. Use this to return only specific player metrics by Type ID or domain group.

Ratings are 380–383 (Impact, Aggression, Discipline, SST Rating); expected metrics for the fixture are 384 (Expected Shots), 385 (Expected Minutes), 386 (Expected Goals), 387 (Expected Assists), 388 (Expected Goal Involvements), 389 (Expected Shots on Target) and 390 (Expected Booking Points). A listing view typically wants types:380,383; a player-props view wants types:384,385,386,389,390.

string

Optional filter for the included trends module. Use developer_names to select stats by name, or types to select by type ID. developer_names takes priority when both are provided.

date-time

The start date in ISO 8601 format. Must be within 30 days of the current date and before end_date. Both start_date and end_date must be provided together to enable date range filtering; supplying only one has no effect.

date-time

The end date in ISO 8601 format. Must be after start_date. Both start_date and end_date must be provided together to enable date range filtering; supplying only one has no effect.

string

Optional filter for the included metrics module. Use this to specify which metrics to include based on their Type IDs or domain groups.

string

Refine the odds data by applying specific keys. Use a comma (,) for OR logic within a key and a semicolon (;) for AND logic between different keys.

integer
≥ 1
Defaults to 1

The current page number.

integer
1 to 50
Defaults to 25

Results returned per page. Note that per_page only affects the base entity; included relations are not paginated.

string
enum
Defaults to asc

Sort order of results.

Allowed:
Responses

400

Validation Error (e.g., date range exceeded or invalid format)

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json