Guilded Client
  1. Tournaments
Guilded Client
  • Intro
  • Community Libraries
  • Permissions Values
  • Reference
  • Webhooks
  • Chat
    • Get Embed for URL
      GET
    • Get Metadata
      GET
    • Get Channel Messages
      GET
    • Get Pinned Messages
      GET
  • List Items
    • Get List Items
      GET
    • Get List Item Note
      GET
  • Users
    • Modify User
      GET
    • Get Current User Verification
      GET
    • Send Verification Email
      POST
    • Verify Email Address
      GET
    • Get User Owned Steam Apps
      GET
    • Get User
      GET
    • Get User Profile
      GET
    • Get User Profile Posts
      GET
    • Get User Profile Post
      GET
    • Check Email Address
      GET
  • Teams
    • Get Team Presences
    • Get Team Info
    • Get Shallow Search Results
    • Submit Deep Search Query
    • Check Subdomain
    • Look up Teams
    • Check Team Name
  • Members
    • Get Team Members
    • Detail Team Members
    • Detail Voice Members
    • Sort Member IDs
    • Detail Team Bots
  • Channels
    • Get Team Channels
    • Get Team Channel
    • Get Group Archived Channels
    • Get Thread
    • Get Channel Threads
    • Get Channel Thread Count
    • Get Voice Channel Groups
  • Webhooks
    • Get Channel Webhooks
    • Execute Webhook
  • Guilded Meta
    • Redirect to App
    • Get App QR
  • Tournaments
    • Get Tournaments
      GET
    • Get Tournament
      GET
    • Get Tournament Info
      GET
    • Get Tournament Any Bracket Confirmed
      GET
    • Get Tournament from Invite
      GET
    • Get Tournament Hash Invites
      GET
    • Get Tournament Bracket Matches
      GET
    • Get Upcoming Tournaments
      GET
    • Get Completed Tournaments
      GET
    • Get Featured Tournaments
      GET
  • Websocket
    • Websocket
  1. Tournaments

Get Tournament

GET
/tournaments/{tournamentId}
tournaments
Get a specific tournament

Request

Path Params
tournamentId
string 
required

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://www.guilded.gg/api/tournaments/'

Responses

🟢200OK
application/json
Body
tournament
object (Tournament) 
required
The returned tournament
id
string 
required
The ID of the tournament
name
string 
required
The name of the tournament
description
string  | null 
optional
The description of the tournament, seems to be unused in favor of additionalFields.description
priority
integer  | null 
optional
type
enum<string> 
required
The type of tournament
Allowed value:
tournament
avatar
string  | null 
required
The group avatar URL that the tournament is in or a Guilded asset for the game being played (starting with /asset/)
banner
string  | null 
required
The group banner URL that the tournament is in or a Guilded asset for the game being played (starting with /asset/)
logo
string  | null 
optional
Unknown
teamId
string 
required
The team ID that the tournament is in
gameId
integer  | string 
required
The game being played in the tournament
>= 10100<= 477074
visibilityTeamRoleId
integer  | null 
optional
The role ID required to see the tournament
membershipTeamRoleId
integer  | null 
optional
The role ID required to join the tournament
isBase
boolean 
optional
Unknown
additionalGameInfo
object 
optional
createdBy
string 
optional
The user ID who created the tournament
createdAt
string <date-time>
optional
When the tournament was created
updatedBy
string  | null 
optional
The user ID who last updated the tournament
updatedAt
string <date-time> | null 
optional
When the tournament was last updated
deletedAt
string <date-time> | null 
optional
When the tournament was deleted
customReactionId
integer  | null 
optional
The ID of the emoji associated with the tournament
isPublic
boolean 
optional
Whether the tournament is public
archivedAt
string <date-time> | null 
optional
When the tournament was archived
archivedBy
string  | null 
optional
The user ID who archived the tournament
tournamentId
string 
deprecated
The ID of the tournament (duplicate of id)
isPublished
boolean 
optional
Whether the tournament is published
additionalFields
object  | null 
optional
More fields for the tournament
minRosterSize
integer 
optional
Minimum roster size required for the tournament to begin
maxRosterSize
integer 
optional
Maximum roster size for the tournament
maxParticipants
integer  | null 
optional
Maximum number of participants for the tournament, null if no maximum
customFormId
integer  | null 
optional
The ID of the form associated with the tournament
startDate
string <date-time>
required
When the tournament begins
endDate
string <date-time>
required
When the tournament ends
teamSize
integer 
optional
Unknown
customLineupFormId
integer  | null 
optional
The ID of another form associated with the tournament
tournamentMembers
array [object {5}]  | null 
optional
The members of the tournament
isFeatured
boolean  | null 
optional
Whether the tournament is featured (assume false if null)
staffMembers
array [object {2}] 
optional
Staff members who will be available for the tournament
Example
{
    "tournament": {
        "id": "string",
        "name": "string",
        "description": "string",
        "priority": 0,
        "type": "tournament",
        "avatar": "string",
        "banner": "string",
        "logo": "string",
        "teamId": "string",
        "gameId": 10100,
        "visibilityTeamRoleId": 0,
        "membershipTeamRoleId": 0,
        "isBase": true,
        "additionalGameInfo": {},
        "createdBy": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedBy": "string",
        "updatedAt": "2019-08-24T14:15:22Z",
        "deletedAt": "2019-08-24T14:15:22Z",
        "customReactionId": 0,
        "isPublic": true,
        "archivedAt": "2019-08-24T14:15:22Z",
        "archivedBy": "string",
        "tournamentId": "string",
        "isPublished": true,
        "additionalFields": {
            "prizes": {
                "title": "string",
                "content": {
                    "object": "value",
                    "document": {
                        "object": "document",
                        "data": {
                            "profile": {
                                "name": "shay",
                                "profilePicture": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/WebhookThumbnail/3626a9cdc1020a98bd6c1724049c89a8-Full.webp?w=160&h=160"
                            },
                            "hiddenEmbedUrls": {
                                "{url}": false
                            }
                        },
                        "nodes": [
                            {
                                "object": "block",
                                "type": "markdown-plain-text",
                                "data": {
                                    "isEmbedMessage": false,
                                    "embeds": [
                                        {
                                            "title": "string",
                                            "description": "string",
                                            "url": "string",
                                            "color": 0,
                                            "timestamp": "string",
                                            "footer": {
                                                "text": "string",
                                                "icon_url": "string",
                                                "iconUrl": "string"
                                            },
                                            "thumbnail": {
                                                "url": "string"
                                            },
                                            "image": {
                                                "url": "string"
                                            },
                                            "author": {
                                                "name": "string",
                                                "url": "string",
                                                "icon_url": "string",
                                                "iconUrl": "string"
                                            },
                                            "fields": [
                                                {
                                                    "name": "string",
                                                    "value": "string",
                                                    "inline": true
                                                }
                                            ]
                                        }
                                    ],
                                    "url": "string",
                                    "createdBy": "string",
                                    "oldName": "string",
                                    "newName": "string",
                                    "type": "channel-renamed"
                                },
                                "nodes": [
                                    {
                                        "object": "text",
                                        "type": "mention",
                                        "data": {
                                            "mention": {
                                                "type": "role",
                                                "matcher": "string",
                                                "name": "string",
                                                "nickname": true,
                                                "color": "string",
                                                "id": "string",
                                                "sortOrder": 0
                                            },
                                            "reaction": {
                                                "id": 0,
                                                "customReactionId": 0,
                                                "customReaction": {
                                                    "id": 761262,
                                                    "name": "frog-donut",
                                                    "png": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/CustomReaction/02f8bf8e57fb08568e9260461f34390c-Full.webp?w=120&h=120",
                                                    "webp": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/CustomReaction/02f8bf8e57fb08568e9260461f34390c-Full.webp?w=120&h=120",
                                                    "apng": null
                                                }
                                            },
                                            "channel": {
                                                "id": "string"
                                            },
                                            "href": "string"
                                        },
                                        "leaves": [
                                            {
                                                "object": "leaf",
                                                "text": "string",
                                                "marks": [
                                                    {
                                                        "data": {},
                                                        "object": "mark",
                                                        "type": "bold"
                                                    }
                                                ]
                                            }
                                        ]
                                    }
                                ],
                                "": "string"
                            }
                        ]
                    }
                }
            },
            "sponsors": {
                "title": "string",
                "content": {
                    "object": "value",
                    "document": {
                        "object": "document",
                        "data": {
                            "profile": {
                                "name": "shay",
                                "profilePicture": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/WebhookThumbnail/3626a9cdc1020a98bd6c1724049c89a8-Full.webp?w=160&h=160"
                            },
                            "hiddenEmbedUrls": {
                                "{url}": false
                            }
                        },
                        "nodes": [
                            {
                                "object": "block",
                                "type": "markdown-plain-text",
                                "data": {
                                    "isEmbedMessage": false,
                                    "embeds": [
                                        {
                                            "title": "string",
                                            "description": "string",
                                            "url": "string",
                                            "color": 0,
                                            "timestamp": "string",
                                            "footer": {
                                                "text": "string",
                                                "icon_url": "string",
                                                "iconUrl": "string"
                                            },
                                            "thumbnail": {
                                                "url": "string"
                                            },
                                            "image": {
                                                "url": "string"
                                            },
                                            "author": {
                                                "name": "string",
                                                "url": "string",
                                                "icon_url": "string",
                                                "iconUrl": "string"
                                            },
                                            "fields": [
                                                {
                                                    "name": "string",
                                                    "value": "string",
                                                    "inline": true
                                                }
                                            ]
                                        }
                                    ],
                                    "url": "string",
                                    "createdBy": "string",
                                    "oldName": "string",
                                    "newName": "string",
                                    "type": "channel-renamed"
                                },
                                "nodes": [
                                    {
                                        "object": "text",
                                        "type": "mention",
                                        "data": {
                                            "mention": {
                                                "type": "role",
                                                "matcher": "string",
                                                "name": "string",
                                                "nickname": true,
                                                "color": "string",
                                                "id": "string",
                                                "sortOrder": 0
                                            },
                                            "reaction": {
                                                "id": 0,
                                                "customReactionId": 0,
                                                "customReaction": {
                                                    "id": 761262,
                                                    "name": "frog-donut",
                                                    "png": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/CustomReaction/02f8bf8e57fb08568e9260461f34390c-Full.webp?w=120&h=120",
                                                    "webp": "https://s3-us-west-2.amazonaws.com/www.guilded.gg/CustomReaction/02f8bf8e57fb08568e9260461f34390c-Full.webp?w=120&h=120",
                                                    "apng": null
                                                }
                                            },
                                            "channel": {
                                                "id": "string"
                                            },
                                            "href": "string"
                                        },
                                        "leaves": [
                                            {
                                                "object": "leaf",
                                                "text": "string",
                                                "marks": [
                                                    {
                                                        "data": {},
                                                        "object": "mark",
                                                        "type": "bold"
                                                    }
                                                ]
                                            }
                                        ]
                                    }
                                ],
                                "": "string"
                            }
                        ]
                    }
                }
            },
            "description": "string"
        },
        "minRosterSize": 0,
        "maxRosterSize": 0,
        "maxParticipants": 0,
        "customFormId": 0,
        "startDate": "2019-08-24T14:15:22Z",
        "endDate": "2019-08-24T14:15:22Z",
        "teamSize": 0,
        "customLineupFormId": 0,
        "tournamentMembers": [
            {
                "teamId": "string",
                "userId": "string",
                "createdAt": "2019-08-24T14:15:22Z",
                "tournamentId": "string",
                "membershipRole": "string"
            }
        ],
        "isFeatured": true,
        "staffMembers": [
            {
                "userId": "string",
                "membershipRole": "string"
            }
        ]
    }
}
Modified at 2024-06-10 14:16:22
Previous
Get Tournaments
Next
Get Tournament Info
Built with