LogoLogo
Cricket APISportMonksContactFootball API
  • Welcome
  • Getting Started
    • Getting started
    • All endpoints
    • Enriching your response
  • Our API
    • Introduction to our API
    • Continents
      • GET All Continents
      • GET Continent by ID
    • Countries
      • GET All Countries
      • GET Country by ID
    • Leagues
      • GET All Leagues
      • GET League by ID
    • Seasons
      • GET All Seasons
      • GET Season by ID
    • Fixtures
      • GET All Fixtures
      • GET Fixture by ID
    • Livescores
      • GET All Livescores
    • Teams
      • GET All Teams
      • GET Team by ID
      • GET Squad by Team and Season ID
    • Players
      • GET All Players
      • GET Player by ID
    • Officials
      • GET All Officials
      • GET Official by ID
    • Venues
      • GET All Venues
      • GET Venue by ID
    • Positions
      • GET All Positions
      • GET Position by ID
    • Stages
      • GET All Stages
      • GET Stage by ID
    • Team Rankings
      • GET Global Team Rankings
    • Standings
      • GET Standings by Season ID
      • GET Standings by Stage ID
    • Scores
      • GET All Scores
      • GET Score by ID
  • Relationships
    • Scoreboards
    • Official/Umpries
    • Results
  • API References
  • API Reference Guide
  • API Rate limit
  • Statuses and definitions
  • Demo response files
  • Events
  • Statistics
  • General
  • SportMonks
  • Plans & Pricing
  • FAQ
  • Contact
  • Changelog
    • Changelog
Powered by GitBook
On this page

Was this helpful?

  1. Our API
  2. Fixtures

GET All Fixtures

GET All Fixtures

https://cricket.sportmonks.com/api/v2.0/fixtures

Endpoint details

Authorization

API Key

Pagination

YES

Allowed nested includes

10

Parameters

Available parameters

include

Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.

filter

Array of fields to filter on. Can be used by adding &filter[{field you want to filter}]. For example: &filter[league_id]=4.

fields[object]

Only return fields you are interested in. Every type of data in the response has a resource type, like fixtures or battings. Simply add &fields[object]=id,name,code to your request URL. For example: &fields[fixtures]=id&fields[battings]=active.

sort

One or comma separated list of fields to sort on. Can be used by adding &sort= to your request url.

page

The number of the page you want to browse. Can be used by adding &page= etc to your request url.

Filters

season_id league_id localteam_id visitorteam_id status referee_id round stage_id starts_between

Custom Filters

On this endpoint we offer the option to use a custom date filter to get all fixtures played between 2 dates. Add &filter[starts_between]=2019-03-03,2019-03-15 to the query string to get all games played between these 2 dates.

Sort

You can sort on all fields.

Include options

balls runs bowling batting venue stage season league visitorteam localteam scoreboards firstumpire secondumpire referee manofseries manofmatch tosswon lineup

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

Example response

https://cricket.sportmonks.com/api/v2.0/fixtures?api_token={API_TOKEN}
    "data": [
        {
            "resource": "fixtures",
            "id": 3,
            "league_id": 3,
            "season_id": 6,
            "stage_id": 1755,
            "round": "2nd T20I",
            "localteam_id": 40,
            "visitorteam_id": 41,
            "starting_at": "2018-10-12T16:00:00.000000Z",
            "type": "T20I",
            "live": 0,
            "status": "Finished",
            "last_period": null,
            "note": "South Africa won by 6 wickets (with 26 balls remaining)",
            "venue_id": 96,
            "toss_won_team_id": 41,
            "winner_team_id": 40,
            "draw_noresult": null,
            "first_umpire_id": 36,
            "second_umpire_id": 127,
            "tv_umpire_id": 37,
            "referee_id": 15,
            "man_of_match_id": 80,
            "man_of_series_id": null,
            "total_overs_played": null,
            "elected": "batting",
            "super_over": false,
            "follow_on": false,
            "localteam_dl_data": {
                "score": null,
                "overs": null,
                "wickets_out": null
            },
            "visitorteam_dl_data": {
                "score": null,
                "overs": null,
                "wickets_out": null
            },
            "rpc_overs": null,
            "rpc_target": null,
            "weather_report": []
        },
        {
            "resource": "fixtures",
            "id": 4,
            "league_id": 3,
            "season_id": 6,
            "stage_id": 1755,
            "round": "3rd T20I",
            "localteam_id": 40,
            "visitorteam_id": 41,
            "starting_at": "2018-10-14T12:30:00.000000Z",
            "type": "T20I",
            "live": false,
            "status": "Aban.",
            "last_period": null,
            "note": "Match abandoned without a ball bowled",
            "venue_id": 92,
            "toss_won_team_id": null,
            "winner_team_id": null,
            "draw_noresult": "no-result",
            "first_umpire_id": 37,
            "second_umpire_id": 125,
            "tv_umpire_id": 36,
            "referee_id": 15,
            "man_of_match_id": null,
            "man_of_series_id": null,
            "total_overs_played": null,
            "elected": null,
            "super_over": false,
            "follow_on": false,
            "localteam_dl_data": {
                "score": null,
                "overs": null,
                "wickets_out": null
            },
            "visitorteam_dl_data": {
                "score": null,
                "overs": null,
                "wickets_out": null
            },
            "rpc_overs": null,
            "rpc_target": null,
            "weather_report": []
        },
        {
            "resource": "fixtures",
            "id": 216,
            "league_id": 3,
            "season_id": 6,
            "stage_id": 24,
            "round": "1st T20I",
            "localteam_id": 10,
            "visitorteam_id": 43,
            "starting_at": "2018-11-04T13:30:00.000000Z",
            "type": "T20I",
            "live": true,
            "status": "Finished",
            "last_period": null,
            "note": "India won by 5 wickets (with 13 balls remaining)",
            "venue_id": 64,
            "toss_won_team_id": 10,
            "winner_team_id": 10,
            "draw_noresult": null,
            "first_umpire_id": 57,
            "second_umpire_id": 75,
            "tv_umpire_id": 19,
            "referee_id": 77,
            "man_of_match_id": 56,
            "man_of_series_id": null,
            "total_overs_played": null,
            "elected": "bowling",
            "super_over": false,
            "follow_on": false,
            "localteam_dl_data": {
                "score": null,
                "overs": null,
                "wickets_out": null
            },
            "visitorteam_dl_data": {
                "score": null,
                "overs": null,
                "wickets_out": null
            },
            "rpc_overs": null,
            "rpc_target": null,
            "weather_report": []
        },
PreviousFixturesNextGET Fixture by ID

Last updated 5 months ago

Was this helpful?

To gain more information on the relations available for the include you can use . For example you can use batting.batsman or batting.bowler or batting.runoutby. more option are available.

nested includes
Enriching your response