List Rounds

GET

/races/{race_id}/rounds.json

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

Rounds Response

Body

🟠401Unauthorized

🟠406Not Acceptable

🟠415Unsupported Media Type

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "data": [
        {
            "id": "8008135",
            "type": "RoundOutput",
            "attributes": {
                "round": 1,
                "state": "pending",
                "timestamps": {
                    "startsAt": "string",
                    "createdAt": "string",
                    "updatedAt": "string",
                    "completedAt": "string"
                }
            },
            "relationships": {
                "participants": {
                    "links": {
                        "related": "https://api.challonge.com/<endpoint>/<url>/<relationship>/<relationship_id>.json",
                        "meta": {
                            "count": 0
                        }
                    }
                },
                "elapsedTimes": {}
            },
            "links": {
                "self": "https://api.challonge.com/races/<url>.json"
            }
        }
    ]
}

Modified at 2025-11-04 17:49:20

Change Race State

Get Round