Advertisement
Advertisement

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

Learn More ×

List a tournament's participants (index)

Advertisement

Retrieve a tournament's participant list.


URL

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

Parameters

Name Description
Richiesto
api_key
Your API key (required unless you're using HTTP basic authentication)
Richiesto
{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)

Sample Response

[
  {
    "participant": {
      "active": true,
      "checked_in_at": null,
      "created_at": "2015-01-19T16:54:40-05:00",
      "final_rank": null,
      "group_id": null,
      "icon": null,
      "id": 16543993,
      "invitation_id": null,
      "invite_email": null,
      "misc": null,
      "name": "Participant #1",
      "on_waiting_list": false,
      "seed": 1,
      "tournament_id": 1086875,
      "updated_at": "2015-01-19T16:54:40-05:00",
      "challonge_username": null,
      "challonge_email_address_verified": null,
      "removable": true,
      "participatable_or_invitation_attached": false,
      "confirm_remove": true,
      "invitation_pending": false,
      "display_name_with_invitation_email_address": "Participant #1",
      "email_hash": null,
      "username": null,
      "attached_participatable_portrait_url": null,
      "can_check_in": false,
      "checked_in": false,
      "reactivatable": false
    }
  },
  {
    "participant": {
      "active": true,
      "checked_in_at": null,
      "created_at": "2015-01-19T16:54:43-05:00",
      "final_rank": null,
      "group_id": null,
      "icon": null,
      "id": 16543994,
      "invitation_id": null,
      "invite_email": null,
      "misc": null,
      "name": "Participant #2",
      "on_waiting_list": false,
      "seed": 2,
      "tournament_id": 1086875,
      "updated_at": "2015-01-19T16:54:43-05:00",
      "challonge_username": null,
      "challonge_email_address_verified": null,
      "removable": true,
      "participatable_or_invitation_attached": false,
      "confirm_remove": true,
      "invitation_pending": false,
      "display_name_with_invitation_email_address": "Participant #2",
      "email_hash": null,
      "username": null,
      "attached_participatable_portrait_url": null,
      "can_check_in": false,
      "checked_in": false,
      "reactivatable": false
    }
  },
  {
    "participant": {
      "active": true,
      "checked_in_at": null,
      "created_at": "2015-01-19T16:57:10-05:00",
      "final_rank": null,
      "group_id": null,
      "icon": null,
      "id": 16543996,
      "invitation_id": null,
      "invite_email": null,
      "misc": null,
      "name": "Participant #3",
      "on_waiting_list": false,
      "seed": 3,
      "tournament_id": 1086875,
      "updated_at": "2015-01-19T16:57:10-05:00",
      "challonge_username": null,
      "challonge_email_address_verified": null,
      "removable": true,
      "participatable_or_invitation_attached": false,
      "confirm_remove": true,
      "invitation_pending": false,
      "display_name_with_invitation_email_address": "Participant #3",
      "email_hash": null,
      "username": null,
      "attached_participatable_portrait_url": null,
      "can_check_in": false,
      "checked_in": false,
      "reactivatable": false
    }
  },
  {
    "participant": {
      "active": true,
      "checked_in_at": null,
      "created_at": "2015-01-19T16:57:12-05:00",
      "final_rank": null,
      "group_id": null,
      "icon": null,
      "id": 16543997,
      "invitation_id": null,
      "invite_email": null,
      "misc": null,
      "name": "Participant #4",
      "on_waiting_list": false,
      "seed": 4,
      "tournament_id": 1086875,
      "updated_at": "2015-01-19T16:57:12-05:00",
      "challonge_username": null,
      "challonge_email_address_verified": null,
      "removable": true,
      "participatable_or_invitation_attached": false,
      "confirm_remove": true,
      "invitation_pending": false,
      "display_name_with_invitation_email_address": "Participant #4",
      "email_hash": null,
      "username": null,
      "attached_participatable_portrait_url": null,
      "can_check_in": false,
      "checked_in": false,
      "reactivatable": false
    }
  }
]
<?xml version="1.0" encoding="UTF-8"?>
<participants type="array">
  <participant>
    <active type="boolean">true</active>
    <checked-in-at nil="true"/>
    <created-at>2015-01-19T16:54:40-05:00</created-at>
    <final-rank nil="true"/>
    <group-id nil="true"/>
    <icon nil="true"/>
    <id type="integer">16543993</id>
    <invitation-id nil="true"/>
    <invite-email nil="true"/>
    <misc nil="true"/>
    <name>Participant #1</name>
    <on-waiting-list type="boolean">false</on-waiting-list>
    <seed type="integer">1</seed>
    <tournament-id type="integer">1086875</tournament-id>
    <updated-at>2015-01-19T16:54:40-05:00</updated-at>
    <challonge-username nil="true"/>
    <challonge-email-address-verified nil="true"/>
    <removable type="boolean">true</removable>
    <participatable-or-invitation-attached type="boolean">false</participatable-or-invitation-attached>
    <confirm-remove type="boolean">true</confirm-remove>
    <invitation-pending type="boolean">false</invitation-pending>
    <display-name-with-invitation-email-address>Participant #1</display-name-with-invitation-email-address>
    <email-hash nil="true"/>
    <username nil="true"/>
    <attached-participatable-portrait-url nil="true"/>
    <can-check-in type="boolean">false</can-check-in>
    <checked-in type="boolean">false</checked-in>
    <reactivatable type="boolean">false</reactivatable>
  </participant>
  <participant>
    <active type="boolean">true</active>
    <checked-in-at nil="true"/>
    <created-at>2015-01-19T16:54:43-05:00</created-at>
    <final-rank nil="true"/>
    <group-id nil="true"/>
    <icon nil="true"/>
    <id type="integer">16543994</id>
    <invitation-id nil="true"/>
    <invite-email nil="true"/>
    <misc nil="true"/>
    <name>Participant #2</name>
    <on-waiting-list type="boolean">false</on-waiting-list>
    <seed type="integer">2</seed>
    <tournament-id type="integer">1086875</tournament-id>
    <updated-at>2015-01-19T16:54:43-05:00</updated-at>
    <challonge-username nil="true"/>
    <challonge-email-address-verified nil="true"/>
    <removable type="boolean">true</removable>
    <participatable-or-invitation-attached type="boolean">false</participatable-or-invitation-attached>
    <confirm-remove type="boolean">true</confirm-remove>
    <invitation-pending type="boolean">false</invitation-pending>
    <display-name-with-invitation-email-address>Participant #2</display-name-with-invitation-email-address>
    <email-hash nil="true"/>
    <username nil="true"/>
    <attached-participatable-portrait-url nil="true"/>
    <can-check-in type="boolean">false</can-check-in>
    <checked-in type="boolean">false</checked-in>
    <reactivatable type="boolean">false</reactivatable>
  </participant>
  <participant>
    <active type="boolean">true</active>
    <checked-in-at nil="true"/>
    <created-at>2015-01-19T16:57:10-05:00</created-at>
    <final-rank nil="true"/>
    <group-id nil="true"/>
    <icon nil="true"/>
    <id type="integer">16543996</id>
    <invitation-id nil="true"/>
    <invite-email nil="true"/>
    <misc nil="true"/>
    <name>Participant #3</name>
    <on-waiting-list type="boolean">false</on-waiting-list>
    <seed type="integer">3</seed>
    <tournament-id type="integer">1086875</tournament-id>
    <updated-at>2015-01-19T16:57:10-05:00</updated-at>
    <challonge-username nil="true"/>
    <challonge-email-address-verified nil="true"/>
    <removable type="boolean">true</removable>
    <participatable-or-invitation-attached type="boolean">false</participatable-or-invitation-attached>
    <confirm-remove type="boolean">true</confirm-remove>
    <invitation-pending type="boolean">false</invitation-pending>
    <display-name-with-invitation-email-address>Participant #3</display-name-with-invitation-email-address>
    <email-hash nil="true"/>
    <username nil="true"/>
    <attached-participatable-portrait-url nil="true"/>
    <can-check-in type="boolean">false</can-check-in>
    <checked-in type="boolean">false</checked-in>
    <reactivatable type="boolean">false</reactivatable>
  </participant>
  <participant>
    <active type="boolean">true</active>
    <checked-in-at nil="true"/>
    <created-at>2015-01-19T16:57:12-05:00</created-at>
    <final-rank nil="true"/>
    <group-id nil="true"/>
    <icon nil="true"/>
    <id type="integer">16543997</id>
    <invitation-id nil="true"/>
    <invite-email nil="true"/>
    <misc nil="true"/>
    <name>Participant #4</name>
    <on-waiting-list type="boolean">false</on-waiting-list>
    <seed type="integer">4</seed>
    <tournament-id type="integer">1086875</tournament-id>
    <updated-at>2015-01-19T16:57:12-05:00</updated-at>
    <challonge-username nil="true"/>
    <challonge-email-address-verified nil="true"/>
    <removable type="boolean">true</removable>
    <participatable-or-invitation-attached type="boolean">false</participatable-or-invitation-attached>
    <confirm-remove type="boolean">true</confirm-remove>
    <invitation-pending type="boolean">false</invitation-pending>
    <display-name-with-invitation-email-address>Participant #4</display-name-with-invitation-email-address>
    <email-hash nil="true"/>
    <username nil="true"/>
    <attached-participatable-portrait-url nil="true"/>
    <can-check-in type="boolean">false</can-check-in>
    <checked-in type="boolean">false</checked-in>
    <reactivatable type="boolean">false</reactivatable>
  </participant>
</participants>