# GET /tournaments/:id/disciplines/:disciplineId/matches

This endpoint retrieves all matches for a specific discipline within a tournament. The response is an array of match objects, structured the same way as described in the Get Match Details endpoint.

:::note
Matches are returned across all stages, groups, and rounds within the discipline.
:::

## Parameters

| Parameter | In | Example |
| --- | --- | --- |
| `id` | path | `tio:4AHchFkVAecs2` |
| `disciplineId` | path | `tio:in5fqFoUxhiQl` |

## Responses

```json
[
  {
    "id": "tio:dWT5oSbv2kYQg",
    "entries": [
      {
        "id": "05-2553_05-4357",
        "name": "Helmut Poppen / Sophia Poppen",
        "entries": [
          {
            "id": "05-2553",
            "name": "Helmut Poppen"
          },
          {
            "id": "05-4357",
            "name": "Sophia Poppen"
          }
        ]
      },
      {
        "id": "05-9012_05-9876",
        "name": "Caroline Conrad / Andrei Andros",
        "entries": [
          {
            "id": "05-9876",
            "name": "Caroline Conrad"
          },
          {
            "id": "05-9012",
            "name": "Andrei Andros"
          }
        ]
      }
    ],
    "state": "played",
    "encounters": [[[1, 7]]],
    "displayScore": [1, 7],
    "disciplineId": "tio:JHriFxv2ZBCYD",
    "disciplineName": "[D1] Discipline 1",
    "roundId": "tio:S0U825dvJ8v5a",
    "roundName": "Round 1",
    "groupId": "tio:bEC14gDhxf5pT",
    "groupName": "Qualification",
    "courtIds": ["tio:dLUOkXt5oHEvq"],
    "startTime": "2024-07-03T14:39:16.575Z",
    "endTime": "2024-08-09T18:09:36.210Z"
  },
  ...
]
```