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

{
    "data": [
        {
            "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 2026-03-31 19:11:40

Unregister Me

Get Match