All pages
Powered by GitBook
1 of 3

Loading...

Loading...

Loading...

GET Rounds by Season ID

GET Rounds by Season ID

https://soccer.sportmonks.com/api/v2.0/rounds/season/{ID}

Endpoint details

Authorization

API Key

Pagination

NO

Allowed nested includes

2

Parameters

Available parameters

include

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

Include options

fixtures results season league

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://soccer.sportmonks.com/api/v2.0/rounds/season/17141?api_token={API_TOKEN}
   "data": [
        {
            "id": 194968,
            "name": 1,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-08-01",
            "end": "2020-08-03"
        },
        {
            "id": 194969,
            "name": 2,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-08-08",
            "end": "2020-08-09"
        },
        {
            "id": 194970,
            "name": 3,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-08-11",
            "end": "2020-08-12"
        },
        {
            "id": 194971,
            "name": 4,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-08-15",
            "end": "2020-08-16"
        },
        {
            "id": 194972,
            "name": 5,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-08-22",
            "end": "2020-08-23"
        },
        {
            "id": 194973,
            "name": 6,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-08-29",
            "end": "2020-08-30"
        },
        {
            "id": 194974,
            "name": 7,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-09-12",
            "end": "2020-09-12"
        },
        {
            "id": 194975,
            "name": 8,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-09-19",
            "end": "2020-09-20"
        },
        {
            "id": 194976,
            "name": 9,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-09-26",
            "end": "2020-09-27"
        },
        {
            "id": 194977,
            "name": 10,
            "league_id": 501,
            "season_id": 17141,
            "stage_id": 77447501,
            "start": "2020-10-02",
            "end": "2020-10-04"
        },

Field

Description

id

The unique id of the round

name

The name of the round

league_id

The unique league id the round belongs to

season_id

The unique season id the round belongs to

stage_id

The unique stage id the round belongs to

start

The start date of the round

end

The end date of the round

Check this endpoint in Postman.

Includes
Run in Postman

Rounds

Leagues can be split up into Rounds representing a week a game is played in. With this endpoint we give you the ability to request data for a single Round as well as all Rounds of a Season.

The endpoint is often used in combination with includes like Results or Fixtures to show them based on Rounds.

Check this endpoint in Postman.

Run in Postman

GET Round by ID

GET Rounds by ID

https://soccer.sportmonks.com/api/v2.0/rounds/{ID}

Endpoint details

Authorization

API Key

Pagination

NO

Allowed nested includes

2

Parameters

Available parameters

include

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

Include options

fixtures results season league

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://soccer.sportmonks.com/api/v2.0/rounds/194968?api_token={API_TOKEN}
   "data": {
        "id": 194968,
        "name": 1,
        "league_id": 501,
        "season_id": 17141,
        "stage_id": 77447501,
        "start": "2020-08-01",
        "end": "2020-08-03"
    }

Field

Description

id

The unique id of the round

name

The name of the round

league_id

The unique league id the round belongs to

season_id

The unique season id the round belongs to

stage_id

The unique stage id the round belongs to

start

The start date of the round

end

The end date of the round

Check this endpoint in Postman.

Includes
Run in Postman