Mark a match as underway

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

Sets "underway_at" to the current time and highlights the match in the bracket

URL


POST

https://api.challonge.com/v1/tournaments/{tournament}/matches/{match_id}/mark_as_underway.{json|xml}

Parameters

Name	Description
Wymagane `api_key`	Your API key (required unless you're using HTTP basic authentication)
Wymagane `{tournament} (in URL string)`	Tournament ID (e.g. 10230) or URL (e.g. 'single_elim' for challonge.com/single_elim). If assigned to a subdomain, URL format must be `:subdomain-:tournament_url` (e.g. 'test-mytourney' for test.challonge.com/mytourney)
Wymagane `{match_id} (in URL string)`	The match's unique ID

{
  "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": null,
    "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": "open",
    "tournament_id": 1086875,
    "underway_at": "2025-10-25T21:26:47.892+00:00",
    "updated_at": "2015-01-19T16:57:17-05:00",
    "winner_id": null,
    "prerequisite_match_ids_csv": "",
    "scores_csv": ""
  }
}

<?xml version="1.0" encoding="UTF-8"?>
<match>
  <attachment-count nil="true"/>
  <created-at>2015-01-19T16:57:17-05:00</created-at>
  <group-id nil="true"/>
  <has-attachment type="boolean">false</has-attachment>
  <id type="integer">23575258</id>
  <identifier>A</identifier>
  <location nil="true"/>
  <loser-id nil="true"/>
  <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"/>
  <started-at>2015-01-19T16:57:17-05:00</started-at>
  <state>open</state>
  <tournament-id type="integer">1086875</tournament-id>
  <underway-at type="dateTime">2025-10-25T21:26:47+00:00</underway-at>
  <updated-at>2015-01-19T16:57:17-05:00</updated-at>
  <winner-id nil="true"/>
  <prerequisite-match-ids-csv></prerequisite-match-ids-csv>
  <scores-csv></scores-csv>
</match>