Challonge API Docs
  1. Tournaments
Challonge API Docs
  • Guides
    • Welcome
    • Changelog
    • Upgrading
      • Upgrading from v2.0 to v2.1
    • Sample Use Cases
      • Running a Two-Stage Tournament
    • Challonge Connect
      • About
      • Game Integration (beta)
      • Connect Request Signing
  • API v2.1
    • Getting Started
    • Authorization
    • Error Responses
    • Resource Scoping
    • OAuth
      • Scopes
      • Grant Request
      • Token Request
      • Refresh Token Request
      • Device Grant Authorization Request
      • Device Grant Access Token Request
    • Tournament API
      • Tournaments
        • Tournament States
        • List Tournaments
        • Create Tournament
        • Get Tournament
        • Update Tournament
        • Delete Tournament
        • Change Tournament State
      • Participants
        • List Participants
        • Create Participant
        • Get Participant
        • Update Participant
        • Delete Participant
        • Bulk Create Participants
        • Clear All Participants
        • Randomize Participants
        • Register Me
      • Matches
        • List Matches
        • Get Match
        • Update Match
        • Change Match State
      • Match Attachments
        • List Match Attachments
        • Create Match Attachment
        • Delete Match Attachment
    • Race API
      • Races
        • List Races
        • Create Race
        • Get Race
        • Update Race
        • Delete Race
        • Change Race State
      • Rounds
        • List Rounds
        • Get Round
        • Update Round
      • Elapsed Times
        • List Elapsed Times
        • Get Elapsed Time
        • Update Elapsed Time
        • Bulk Update Elapsed Times
    • Get User
      GET
    • List Communities
      GET
    • Schemas
      • MatchAttachmentModel
      • MatchAttachmentInput
      • MatchAttachmentOutput
      • MatchAttachment
      • ParticipantModel
      • ParticipantOutput
      • ParticipantInput
      • ParticipantBulkInput
      • Participant
      • TournamentModel
      • TournamentInput
      • Tournament
      • TournamentStateInput
      • CommunityModel
      • Community
      • MatchModel
      • MatchInput
      • MatchOutput
      • Match
      • MatchStateInput
      • ErrorModel
      • UserModel
      • User
      • ElapsedTimeBulkInput
      • ElapsedTimeWithID
      • ElapsedTimeOutput
      • ElaspedTimeInput
      • Timestamps
      • RelationshipLink
      • RoundOutput
      • RoundStateInput
      • RacingOutput
      • RacingInput
      • RacingStateInput
  • Bracket JSAPI v1.0
    • Getting Started
    • Broadcasted Events
    • API Actions
      • scrollToCoordinates
      • scrollToMatchIdentifier
      • setZoomScale
      • zoomToCoordinate
      • zoomToMatchIdentifier
      • loadTheme
      • filterRounds
      • loadIntegrationData
      • setBracketSettings
  • API v2.0 (deprecated)
    • About
    • Deprecated Endpoints
      • Tournament
        • findTournaments
        • createTournament
        • showTournament
        • updateTournament
        • deleteTournament
        • changeStateTournament
      • Match
        • findMatches
        • showMatch
        • updateMatch
        • changeStateTournament
      • Participant
        • findParticipants
        • createParticipant
        • showParticipant
        • updateParticipant
        • deleteParticipant
        • bulkCreateParticipant
        • clearAllParticipants
        • randomizeParticipants
      • Match Attachment
        • findMatchAttachments
        • createMatchAttachments
        • deleteMatchAttachment
      • Race
        • findRaces
        • createRace
        • showRace
        • updateRace
        • deleteRace
        • changeStateRace
      • Round
        • findRounds
        • showRound
        • updateRound
      • Elapsed Time
        • findElapsedTime
        • showElapsedTime
        • updateElapsedTime
        • bulkUpdateElapsedTime
      • User
        • findUser
        • findCommunities
    • Schemas
      • MatchAttachmentModel
      • MatchAttachmentInput
      • MatchAttachmentOutput
      • MatchAttachment
      • ParticipantModel
      • ParticipantOutput
      • ParticipantInput
      • ParticipantBulkInput
      • Participant
      • TournamentModel
      • TournamentInput
      • Tournament
      • TournamentStateInput
      • CommunityModel
      • Community
      • MatchModel
      • MatchInput
      • MatchOutput
      • Match
      • MatchStateInput
      • ErrorModel
      • UserModel
      • User
      • ElapsedTimeBulkInput
      • ElapsedTimeWithID
      • ElapsedTimeOutput
      • ElaspedTimeInput
      • Timestamps
      • RelationshipLink
      • RoundOutput
      • RoundStateInput
      • RacingOutput
      • RacingInput
      • RacingStateInput
  • API v1 (deprecated)
    • About
    • Deprecated Endpoints
      • Tournaments
        • List tournaments
          GET
        • Create a tournament
          POST
        • Get a tournament
          GET
        • Update a tournament
          PUT
        • Delete a tournament
          DELETE
        • Process check-in results for a tournament
          POST
        • Abort check-in for a tournament
          POST
        • Start a tournament
          POST
        • Finalize a tournament
          POST
        • Reset a tournament
          POST
        • Open for predictions
          POST
      • Participants
        • List a tournament's participants
        • Create a participant
        • Bulk create participants
        • Get a participant
        • Update a participant
        • Check in a participant
        • Undo check-in for a participant
        • Delete/deactivate a participant
        • Clear/delete all participants
        • Randomize a tournament's participants
      • Matches
        • List a tournament's matches
        • Get a match
        • Update a match
        • Reopen a match
        • Mark a match as underway
        • Unmark a match as underway
      • Match Attachments
        • List a match's attachments
        • Create a match attachment
        • Get a match attachment
        • Update a match attachment
        • Delete a match attachment
  1. Tournaments

Get a tournament

Deprecated
GET
/tournament/{tournament}.json
Retrieve a single tournament record created with your account.

Request

Authorization
API Key
Add parameter in query
api_key
Example:
api_key: ********************
or
Path Params

Query Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.challonge.com/v1/tournament/.json?include_participants&include_matches&api_key=<api-key>'
Response Response Example
{
    "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
    }
}
Modified at 2025-11-05 17:14:55
Previous
Create a tournament
Next
Update a tournament
Built with