Update a match

Deprecated

PUT

/tournaments/{tournament}/matches/{match_id}.json

Update/submit the score(s) for a match.

If you're updating winner_id, scores_csv must also be provided. You may, however, update score_csv without providing winner_id for live score updates.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

api_key: ********************

Path Params

Query Params

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request PUT 'https://api.challonge.com/v1/tournaments//matches/.json?match[scores_csv]&match[winner_id]&match[player1_votes]&match[player2_votes]&api_key=<api-key>'

Response Example

{
    "match": {
        "attachment_count": null,
        "created_at": "2015-01-19T16:57:17-05:00",
        "group_id": null,
        "has_attachment": false,
        "id": 23575258,
        "identifier": "A",
        "location": null,
        "loser_id": 16543997,
        "player1_id": 16543993,
        "player1_is_prereq_match_loser": false,
        "player1_prereq_match_id": null,
        "player1_votes": null,
        "player2_id": 16543997,
        "player2_is_prereq_match_loser": false,
        "player2_prereq_match_id": null,
        "player2_votes": null,
        "round": 1,
        "scheduled_time": null,
        "started_at": "2015-01-19T16:57:17-05:00",
        "state": "complete",
        "tournament_id": 1086875,
        "underway_at": null,
        "updated_at": "2015-01-19T16:57:17-05:00",
        "winner_id": 16543993,
        "prerequisite_match_ids_csv": "",
        "scores_csv": "3-1,3-2"
    }
}

Modified at 2025-11-05 18:43:33

Get a match

Reopen a match