List Matches

GET

/tournaments/{tournament_id}/matches.json

Returns matches based on the tournament ID given

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://api.challonge.com/oauth/authorize

Token URL: https://api.challonge.com/oauth/token

Path Params

Query Params

Header Params

Responses

🟢200OK

application/json

Tournament Matches Response

Body

🟠401Unauthorized

🟠406Not Acceptable

🟠415Unsupported Media Type

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.challonge.com/v2.1/tournaments//matches.json?community_id&page&per_page&state&participant_id' \
--header 'Accept;' \
--header 'Authorization-Type;' \
--header 'If-None-Match;' \
--header 'Authorization: <api-key>'

Response Example

200 - Example 1

[
    {
        "id": "8008135",
        "type": "match",
        "attributes": {
            "state": "complete",
            "round": 1,
            "identifier": "A",
            "suggested_play_order": 1,
            "scores": "2 - 0",
            "score_in_sets": [
                [
                    3,
                    1
                ],
                [
                    4,
                    2
                ]
            ],
            "points_by_participant": [
                {
                    "participant_id": 355,
                    "scores": [
                        3,
                        4
                    ]
                },
                {
                    "participant_id": 354,
                    "scores": [
                        1,
                        2
                    ]
                }
            ],
            "timestamps": {
                "created_at": "2023-04-21T14:29:06.374Z",
                "updated_at": "2023-04-21T14:31:45.981Z"
            },
            "winner_id": 355,
            "relationships": {
                "player1": {
                    "data": {
                        "id": "355",
                        "type": "participant"
                    }
                },
                "player2": {
                    "data": {
                        "id": "354",
                        "type": "participant"
                    }
                }
            }
        }
    }
]

Modified at 2025-11-04 17:47:18

Get Match