📣 Challonge is now owner-operated! Read More. We've also made some updates to our Terms of Service and Privacy Policy.
 

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

Learn More ×

Retrieve a set of tournaments created with your account.


URL

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

Parameters

Name Description
Required
api_key
Your API key (required unless you're using HTTP basic authentication)
state all, pending, in_progress, ended
type single_elimination, double_elimination, round_robin, swiss
created_after YYYY-MM-DD
created_before YYYY-MM-DD
subdomain A Challonge subdomain you've published tournaments to. NOTE: Until v2 of our API, the subdomain parameter is required to retrieve a list of your organization-hosted tournaments.

Sample Response

[
  {
    "tournament": {
      "accept_attachments": false,
      "allow_participant_match_reporting": true,
      "anonymous_voting": false,
      "category": null,
      "check_in_duration": null,
      "completed_at": null,
      "created_at": "2015-01-19T16:47:30-05:00",
      "created_by_api": false,
      "credit_capped": false,
      "description": "",
      "game_id": 600,
      "group_stages_enabled": false,
      "hide_forum": false,
      "hide_seeds": false,
      "hold_third_place_match": false,
      "id": 1086875,
      "max_predictions_per_user": 1,
      "name": "Sample Tournament 1",
      "notify_users_when_matches_open": true,
      "notify_users_when_the_tournament_ends": true,
      "open_signup": false,
      "participants_count": 4,
      "prediction_method": 0,
      "predictions_opened_at": null,
      "private": false,
      "progress_meter": 0,
      "pts_for_bye": "1.0",
      "pts_for_game_tie": "0.0",
      "pts_for_game_win": "0.0",
      "pts_for_match_tie": "0.5",
      "pts_for_match_win": "1.0",
      "quick_advance": false,
      "ranked_by": "match wins",
      "require_score_agreement": false,
      "rr_pts_for_game_tie": "0.0",
      "rr_pts_for_game_win": "0.0",
      "rr_pts_for_match_tie": "0.5",
      "rr_pts_for_match_win": "1.0",
      "sequential_pairings": false,
      "show_rounds": true,
      "signup_cap": null,
      "start_at": null,
      "started_at": "2015-01-19T16:57:17-05:00",
      "started_checking_in_at": null,
      "state": "underway",
      "swiss_rounds": 0,
      "teams": false,
      "tie_breaks": [
        "match wins vs tied",
        "game wins",
        "points scored"
      ],
      "tournament_type": "single elimination",
      "updated_at": "2015-01-19T16:57:17-05:00",
      "url": "sample_tournament_1",
      "description_source": "",
      "subdomain": null,
      "full_challonge_url": "http://challonge.com/sample_tournament_1",
      "live_image_url": "http://images.challonge.com/sample_tournament_1.png",
      "sign_up_url": null,
      "review_before_finalizing": true,
      "accepting_predictions": false,
      "participants_locked": true,
      "game_name": "Table Tennis",
      "participants_swappable": false,
      "team_convertable": false,
      "group_stages_were_started": false
    }
  },
  {
    "tournament": {
      "accept_attachments": false,
      "allow_participant_match_reporting": true,
      "anonymous_voting": false,
      "category": null,
      "check_in_duration": null,
      "completed_at": null,
      "created_at": "2015-01-19T16:49:28-05:00",
      "created_by_api": false,
      "credit_capped": false,
      "description": "",
      "game_id": 381,
      "group_stages_enabled": false,
      "hide_forum": false,
      "hide_seeds": false,
      "hold_third_place_match": false,
      "id": 1086876,
      "max_predictions_per_user": 1,
      "name": "Sample Tournament 2",
      "notify_users_when_matches_open": true,
      "notify_users_when_the_tournament_ends": true,
      "open_signup": false,
      "participants_count": 0,
      "prediction_method": 0,
      "predictions_opened_at": null,
      "private": false,
      "progress_meter": 0,
      "pts_for_bye": "1.0",
      "pts_for_game_tie": "0.0",
      "pts_for_game_win": "0.0",
      "pts_for_match_tie": "0.5",
      "pts_for_match_win": "1.0",
      "quick_advance": false,
      "ranked_by": "match wins",
      "require_score_agreement": false,
      "rr_pts_for_game_tie": "0.0",
      "rr_pts_for_game_win": "0.0",
      "rr_pts_for_match_tie": "0.5",
      "rr_pts_for_match_win": "1.0",
      "sequential_pairings": false,
      "show_rounds": true,
      "signup_cap": null,
      "start_at": null,
      "started_at": null,
      "started_checking_in_at": null,
      "state": "pending",
      "swiss_rounds": 0,
      "teams": false,
      "tie_breaks": [
        "match wins vs tied",
        "game wins",
        "points scored"
      ],
      "tournament_type": "round robin",
      "updated_at": "2015-01-19T16:49:28-05:00",
      "url": "sample_tournament_2",
      "description_source": "",
      "subdomain": null,
      "full_challonge_url": "http://challonge.com/sample_tournament_2",
      "live_image_url": "http://images.challonge.com/sample_tournament_2.png",
      "sign_up_url": null,
      "review_before_finalizing": true,
      "accepting_predictions": false,
      "participants_locked": false,
      "game_name": "StarCraft II: Heart of the Swarm",
      "participants_swappable": true,
      "team_convertable": false,
      "group_stages_were_started": false
    }
  }
]
<?xml version="1.0" encoding="UTF-8"?>
<tournaments type="array">
  <tournament>
    <accept-attachments type="boolean">false</accept-attachments>
    <allow-participant-match-reporting type="boolean">true</allow-participant-match-reporting>
    <anonymous-voting type="boolean">false</anonymous-voting>
    <category nil="true"/>
    <check-in-duration nil="true"/>
    <completed-at nil="true"/>
    <created-at>2015-01-19T16:47:30-05:00</created-at>
    <created-by-api type="boolean">false</created-by-api>
    <credit-capped type="boolean">false</credit-capped>
    <description></description>
    <game-id type="integer">600</game-id>
    <group-stages-enabled type="boolean">false</group-stages-enabled>
    <hide-forum type="boolean">false</hide-forum>
    <hide-seeds type="boolean">false</hide-seeds>
    <hold-third-place-match type="boolean">false</hold-third-place-match>
    <id type="integer">1086875</id>
    <max-predictions-per-user type="integer">1</max-predictions-per-user>
    <name>Sample Tournament 1</name>
    <notify-users-when-matches-open type="boolean">true</notify-users-when-matches-open>
    <notify-users-when-the-tournament-ends type="boolean">true</notify-users-when-the-tournament-ends>
    <open-signup type="boolean">false</open-signup>
    <participants-count type="integer">4</participants-count>
    <prediction-method type="integer">0</prediction-method>
    <predictions-opened-at nil="true"/>
    <private type="boolean">false</private>
    <progress-meter type="integer">0</progress-meter>
    <pts-for-bye>1.0</pts-for-bye>
    <pts-for-game-tie>0.0</pts-for-game-tie>
    <pts-for-game-win>0.0</pts-for-game-win>
    <pts-for-match-tie>0.5</pts-for-match-tie>
    <pts-for-match-win>1.0</pts-for-match-win>
    <quick-advance type="boolean">false</quick-advance>
    <ranked-by>match wins</ranked-by>
    <require-score-agreement type="boolean">false</require-score-agreement>
    <rr-pts-for-game-tie>0.0</rr-pts-for-game-tie>
    <rr-pts-for-game-win>0.0</rr-pts-for-game-win>
    <rr-pts-for-match-tie>0.5</rr-pts-for-match-tie>
    <rr-pts-for-match-win>1.0</rr-pts-for-match-win>
    <sequential-pairings type="boolean">false</sequential-pairings>
    <show-rounds type="boolean">true</show-rounds>
    <signup-cap nil="true"/>
    <start-at nil="true"/>
    <started-at>2015-01-19T16:57:17-05:00</started-at>
    <started-checking-in-at nil="true"/>
    <state>underway</state>
    <swiss-rounds type="integer">0</swiss-rounds>
    <teams type="boolean">false</teams>
    <tie-breaks type="array">
      <tie-break>match wins vs tied</tie-break>
      <tie-break>game wins</tie-break>
      <tie-break>points scored</tie-break>
    </tie-breaks>
    <tournament-type>single elimination</tournament-type>
    <updated-at>2015-01-19T16:57:17-05:00</updated-at>
    <url>sample_tournament_1</url>
    <description-source></description-source>
    <subdomain nil="true"/>
    <full-challonge-url>http://challonge.com/sample_tournament_1</full-challonge-url>
    <live-image-url>http://images.challonge.com/sample_tournament_1.png</live-image-url>
    <sign-up-url nil="true"/>
    <review-before-finalizing type="boolean">true</review-before-finalizing>
    <accepting-predictions type="boolean">false</accepting-predictions>
    <participants-locked type="boolean">true</participants-locked>
    <game-name>Table Tennis</game-name>
    <participants-swappable type="boolean">false</participants-swappable>
    <team-convertable type="boolean">false</team-convertable>
    <group-stages-were-started type="boolean">false</group-stages-were-started>
  </tournament>
  <tournament>
    <accept-attachments type="boolean">false</accept-attachments>
    <allow-participant-match-reporting type="boolean">true</allow-participant-match-reporting>
    <anonymous-voting type="boolean">false</anonymous-voting>
    <category nil="true"/>
    <check-in-duration nil="true"/>
    <completed-at nil="true"/>
    <created-at>2015-01-19T16:49:28-05:00</created-at>
    <created-by-api type="boolean">false</created-by-api>
    <credit-capped type="boolean">false</credit-capped>
    <description></description>
    <game-id type="integer">381</game-id>
    <group-stages-enabled type="boolean">false</group-stages-enabled>
    <hide-forum type="boolean">false</hide-forum>
    <hide-seeds type="boolean">false</hide-seeds>
    <hold-third-place-match type="boolean">false</hold-third-place-match>
    <id type="integer">1086876</id>
    <max-predictions-per-user type="integer">1</max-predictions-per-user>
    <name>Sample Tournament 2</name>
    <notify-users-when-matches-open type="boolean">true</notify-users-when-matches-open>
    <notify-users-when-the-tournament-ends type="boolean">true</notify-users-when-the-tournament-ends>
    <open-signup type="boolean">false</open-signup>
    <participants-count type="integer">0</participants-count>
    <prediction-method type="integer">0</prediction-method>
    <predictions-opened-at nil="true"/>
    <private type="boolean">false</private>
    <progress-meter type="integer">0</progress-meter>
    <pts-for-bye>1.0</pts-for-bye>
    <pts-for-game-tie>0.0</pts-for-game-tie>
    <pts-for-game-win>0.0</pts-for-game-win>
    <pts-for-match-tie>0.5</pts-for-match-tie>
    <pts-for-match-win>1.0</pts-for-match-win>
    <quick-advance type="boolean">false</quick-advance>
    <ranked-by>match wins</ranked-by>
    <require-score-agreement type="boolean">false</require-score-agreement>
    <rr-pts-for-game-tie>0.0</rr-pts-for-game-tie>
    <rr-pts-for-game-win>0.0</rr-pts-for-game-win>
    <rr-pts-for-match-tie>0.5</rr-pts-for-match-tie>
    <rr-pts-for-match-win>1.0</rr-pts-for-match-win>
    <sequential-pairings type="boolean">false</sequential-pairings>
    <show-rounds type="boolean">true</show-rounds>
    <signup-cap nil="true"/>
    <start-at nil="true"/>
    <started-at nil="true"/>
    <started-checking-in-at nil="true"/>
    <state>pending</state>
    <swiss-rounds type="integer">0</swiss-rounds>
    <teams type="boolean">false</teams>
    <tie-breaks type="array">
      <tie-break>match wins vs tied</tie-break>
      <tie-break>game wins</tie-break>
      <tie-break>points scored</tie-break>
    </tie-breaks>
    <tournament-type>round robin</tournament-type>
    <updated-at>2015-01-19T16:49:28-05:00</updated-at>
    <url>sample_tournament_2</url>
    <description-source></description-source>
    <subdomain nil="true"/>
    <full-challonge-url>http://challonge.com/sample_tournament_2</full-challonge-url>
    <live-image-url>http://images.challonge.com/sample_tournament_2.png</live-image-url>
    <sign-up-url nil="true"/>
    <review-before-finalizing type="boolean">true</review-before-finalizing>
    <accepting-predictions type="boolean">false</accepting-predictions>
    <participants-locked type="boolean">false</participants-locked>
    <game-name>StarCraft II: Heart of the Swarm</game-name>
    <participants-swappable type="boolean">true</participants-swappable>
    <team-convertable type="boolean">false</team-convertable>
    <group-stages-were-started type="boolean">false</group-stages-were-started>
  </tournament>
</tournaments>
Advertisement
Advertisement