> For the complete documentation index, see [llms.txt](https://docs.sportmonks.com/v2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportmonks.com/v2/endpoint-overview/rounds/get-rounds-by-season-id.md).

# 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`<br>

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.&#x20;

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

{% content-ref url="/pages/-MJXOeyBzTS35Z7kTf1c" %}
[Includes](/v2/tutorials/enriching-your-response/includes.md)
{% endcontent-ref %}

#### Example response

{% tabs %}
{% tab title="Request" %}

```
https://soccer.sportmonks.com/api/v2.0/rounds/season/17141?api_token={API_TOKEN}
```

{% endtab %}

{% tab title="Response" %}

```javascript
   "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"
        },
```

{% endtab %}

{% tab title="Field Description" %}

| **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                 |
| {% endtab %}  |                                           |
| {% endtabs %} |                                           |

{% hint style="info" %}
Check this endpoint in Postman.\
&#x20;                                                             [![Run in Postman](https://run.pstmn.io/button.svg)](https://football-postman.sportmonks.com/#d97e9be1-bef7-4a19-9132-fd1b60131122)
{% endhint %}