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.

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.

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

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

Ratings are 380383 (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