SETTO API

A tournament's teams (pairs, players or league teams)

GET
/v1/external/tournaments/{idx}/teams

Ordered by seed, then name. Narrow to one category with division=<division idx>. An unknown or out-of-organization tournament is a 404. populate is a comma-separated list of relation paths. Allowed: playerProfiles, captainProfile, leagueTeam, division. Default when omitted: playerProfiles, division. A path outside that list is a 400. Relations that were not requested are absent from the response body (not null). All identifiers (idx) are v4 UUIDs.

Authorization

apiToken
AuthorizationBearer <token>

Organization API token

In: header

Path Parameters

idx*string

Tournament identifier

Formatuuid

Query Parameters

populate?string

Comma-separated. Allowed: playerProfiles, captainProfile, leagueTeam, division

division?string

Only teams in this division (division idx)

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/external/tournaments/497f6eca-6276-4993-bfeb-53cbbbba6f08/teams"
[  {    "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",    "name": "Lugo / Ramirez",    "seed": 3,    "seedNumber": 1,    "club": "Club Deportivo Santa Fe",    "picture": "https://cdn.setto.io/teams/lugo-ramirez.png",    "description": "Campeones 2025",    "ranking": 12,    "isWildCard": false,    "qualifierStatus": "COMPETING",    "drawAssignment": "QUALIFYING",    "createdAt": "2026-08-01T17:30:00.000Z",    "division": {      "idx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b",      "name": "Primera Varonil"    },    "players": [      {        "idx": "c9d0e1f2-a3b4-4567-8c8d-9e0f1a2b3c4d",        "firstName": "Mario",        "lastName": "Lugo",        "avatar": "https://cdn.setto.io/avatars/mario-lugo.png"      }    ],    "captainProfileIdx": "c9d0e1f2-a3b4-4567-8c8d-9e0f1a2b3c4d",    "leagueTeam": {      "idx": "d0e1f2a3-b4c5-4678-8d9e-0f1a2b3c4d5e",      "name": "Club Santa Fe",      "color": "#1E3A8A",      "logo": "https://cdn.setto.io/league-teams/santa-fe.png",      "position": 1,      "pointsAdjustment": 0    }  }]