v20

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011984401.2 MB
Tournament Entry

Get your own state in a tournament

Returns the API key owner's own state in one tournament, resolved by slug: the teams they may act for, their teams' entries, invites addressed to those teams, free-agent offers addressed to them, the rosters they are personally on, and their free-agent pool row. Requires tournaments.actor.entry at read or read-write on the key; a read-only grant is enough, since this endpoint performs no writes.

This is the discovery endpoint for the competitor surface. Most competitor write endpoints are keyed by an opaque resource id - participantId, inviteId, offerId, rosterEntryId - that is returned here and nowhere else, so call this first.

Every collection is an ARRAY and is returned whole, including terminal rows: withdrawn, denied, removed and disqualified entries, responded invites, and expired, declined or revoked offers. A caller acting for several teams in one tournament has several entries and receives all of them. Do not assume at most one of anything.

No viewability filter is applied, because every field is already keyed to the caller. A tournament still in DRAFT that the caller has been invited to therefore answers 200, which is what makes the invite answerable before the tournament is published. A slug that does not resolve at all answers 404.

Unlike the organizer endpoints this call is billed to the KEY OWNER rather than the tournament host, and is gated on the writes API feature (api_pro) rather than on the host's plan - a competitor's integration never depends on the organizer's billing.

get/tournaments/{identifier}/me

Path parameters

identifierstring required

Tournament slug.

Tournament slug.

Response

The caller's state in the tournament.

timestampstring required

Response generation time (ISO 8601).