Advertisement
Advertisement

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

Learn More ×

Get a match (show)

Advertisement

Retrieve a single match record for a tournament.


URL

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

Parameters

Name Description
Gerekli
api_key
Your API key (required unless you're using HTTP basic authentication)
Gerekli
{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)
Gerekli
{match_id} (in URL string)
The match's unique ID
include_attachments 0 or 1; include an array of associated attachment records

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": 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": null,
    "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 nil="true"/>
  <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>