Advertisement
Advertisement

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

Learn More ×

Get a participant (show)

Advertisement

Retrieve a single participant record for a tournament.


URL

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

Parameters

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

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
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<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>