Check out Challonge Connect, our new Tournament API Devkit for your Game, Website, or App.

Learn More ×

Update a match


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


PUT Help{tournament}/matches/{match_id}.{json|xml}


Name Description
Your API key (required unless you're using HTTP basic authentication)
{tournament} (in URL string)
Tournament ID (e.g. 10230) or URL (e.g. 'single_elim' for If assigned to a subdomain, URL format must be :subdomain-:tournament_url (e.g. 'test-mytourney' for
{match_id} (in URL string)
The match's unique ID
match[scores_csv] Comma separated set/game scores with player 1 score first (e.g. "1-3,3-0,3-2")
match[winner_id] The participant ID of the winner or "tie" if applicable (Round Robin and Swiss). NOTE: If you change the outcome of a completed match, all matches in the bracket that branch from the updated match will be reset.
match[player1_votes] Overwrites the number of votes for player 1
match[player2_votes] Overwrites the number of votes for player 2

* 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.

Sample Response

  "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"
<?xml version="1.0" encoding="UTF-8"?>
  <attachment-count nil="true"/>
  <group-id nil="true"/>
  <has-attachment type="boolean">false</has-attachment>
  <id type="integer">23575258</id>
  <location nil="true"/>
  <loser-id type="integer">16543997</loser-id>
  <player1-id type="integer">16543993</player1-id>
  <player1-is-prereq-match-loser type="boolean">false</player1-is-prereq-match-loser>
  <player1-prereq-match-id nil="true"/>
  <player1-votes nil="true"/>
  <player2-id type="integer">16543997</player2-id>
  <player2-is-prereq-match-loser type="boolean">false</player2-is-prereq-match-loser>
  <player2-prereq-match-id nil="true"/>
  <player2-votes nil="true"/>
  <round type="integer">1</round>
  <scheduled-time nil="true"/>
  <tournament-id type="integer">1086875</tournament-id>
  <underway-at nil="true"/>
  <winner-id type="integer">16543993</winner-id>