SETTO API

One tournament by identifier

GET
/v1/external/tournaments/{idx}

A tournament belonging to another organization is a 404, not a 403 — the endpoint is not an existence oracle. populate is a comma-separated list of relation paths. Allowed: club, club.courts, divisions, divisions.rounds, sponsors, circuit, circuitCategory, rankedTiebreakRules. Default when omitted: club, divisions. 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: club, club.courts, divisions, divisions.rounds, sponsors, circuit, circuitCategory, rankedTiebreakRules

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"
{  "idx": "f6a7b8c9-d0e1-4234-8f5a-6b7c8d9e0f1a",  "slug": "liga-conquistadores-2026",  "name": "Liga Conquistadores 2026",  "type": "TOURNAMENT",  "sport": "PADEL",  "status": "IN_PROGRESS",  "startDate": "2026-09-12T00:00:00.000Z",  "endDate": "2026-09-14T00:00:00.000Z",  "timezone": "America/Mexico_City",  "addOneHour": false,  "matchDays": 3,  "americanoRounds": null,  "courtNames": {    "1": "Cancha Central",    "2": "Cancha 2"  },  "scheduleType": "ASSIGNED",  "isPublic": true,  "isFormatComplete": true,  "banner": "https://cdn.setto.io/banners/liga-conquistadores-2026.jpg",  "whoCanSubmit": "ADMINS_ONLY",  "resultApprovalMode": "NONE",  "displayPoints": true,  "matchdayBonusEnabled": true,  "inscriptionCost": 1200,  "totalPrize": 50000,  "standingColumns": [    {      "ordering": 1,      "type": "GAMES_WON"    }  ],  "createdAt": "2026-08-01T16:40:00.000Z",  "publicUrl": "https://www.setto.io/t/liga-conquistadores-2026",  "organization": {    "idx": "e5f6a7b8-c9d0-4123-8e4f-5a6b7c8d9e0f",    "name": "Setto Padel Tour",    "slug": "setto-padel-tour"  },  "club": {    "idx": "7c1b9d2e-3f45-4a68-8b90-1c2d3e4f5a6b",    "name": "Club Deportivo Santa Fe",    "address": "Av. Vasco de Quiroga 3800",    "website": "https://clubsantafe.mx",    "image": "https://cdn.setto.io/clubs/santa-fe.png",    "location": {      "formattedAddress": "Av. Vasco de Quiroga 3800, Santa Fe, 05348 Ciudad de Mexico",      "city": "Ciudad de Mexico",      "country": "Mexico",      "lat": 19.3607,      "lng": -99.2739,      "postalCode": "05348",      "province": "CDMX"    },    "courts": [      {        "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90",        "name": "Cancha 1",        "position": 1      }    ]  },  "divisions": [    {      "idx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b",      "name": "Primera Varonil",      "number": 1,      "color": "#1E3A8A",      "isDoubles": true,      "isVisible": true,      "price": 1200,      "minParticipants": null,      "maxParticipants": null,      "maxRegistrations": 32,      "createdAt": "2026-08-01T16:44:00.000Z",      "tournament": {        "idx": "f6a7b8c9-d0e1-4234-8f5a-6b7c8d9e0f1a"      },      "rounds": [        {          "idx": "a9b0c1d2-e3f4-4567-8a81-920314253647",          "name": "Pool Play",          "type": "ROUND_ROBIN_ROUND",          "number": 1,          "isSetup": true,          "isVisible": true,          "gamesPerTeam": 3,          "gamesRequireWinners": true,          "numberOfSets": 3,          "proSets": false,          "playAllSets": false,          "pointsPerSet": 11,          "placements": [            1,            2          ],          "playEachTeamOnce": true,          "trueDoubleEliminationRound": null,          "numQualifiers": null,          "drawSize": null,          "hasNextRoundTransitioned": false,          "createdAt": "2026-08-20T10:55:00.000Z",          "division": {            "idx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b",            "name": "Primera Varonil"          },          "pools": [            {              "idx": "d6e7f8a9-b0c1-4234-8d5e-6f7081920314",              "name": "Grupo A",              "number": 1,              "teams": [                {                  "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                  "name": "Lugo / Ramirez"                }              ],              "standings": [                {                  "idx": "c5d6e7f8-a9b0-4123-8c4d-5e6f70819203",                  "rank": 1,                  "awardedPoints": 250,                  "team": {                    "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                    "name": "Lugo / Ramirez"                  },                  "teamStats": {                    "idx": "b4c5d6e7-f8a9-4012-8b3c-4d5e6f708192",                    "points": 9,                    "wins": 3,                    "losses": 1,                    "ties": 0,                    "cancelled": 0,                    "forfeits": 0,                    "pointsFor": 24,                    "pointsAgainst": 15,                    "setsPointsFor": 7,                    "setsPointsAgainst": 3,                    "totalGamesPlayed": 4,                    "pointsDifference": 9,                    "setsPointsDifference": 4                  }                }              ]            }          ],          "games": [            {              "idx": "a3b4c5d6-e7f8-4901-8a2b-3c4d5e6f7081",              "number": 7,              "displayNumber": 7,              "status": "FINISHED",              "time": "2026-09-12T16:00:00.000Z",              "lengthInMinutes": 90,              "courtNumber": 2,              "matchDay": 1,              "roundDetail": "Grupo A",              "scheduleNumber": 14,              "sectionNumber": 1,              "isRetirement": false,              "retiredTeamId": null,              "liveStartedAt": null,              "resultApprovalStatus": "PENDING",              "submittedAt": null,              "homeTeamDetails": {                "label": "Del juego 3",                "teamNumber": 2,                "poolNumber": 1,                "poolRank": 1,                "sourceGameNumber": 3,                "sourceResult": "WINNER"              },              "awayTeamDetails": {                "label": "Del juego 3",                "teamNumber": 2,                "poolNumber": 1,                "poolRank": 1,                "sourceGameNumber": 3,                "sourceResult": "WINNER"              },              "createdAt": "2026-08-20T11:02:00.000Z",              "homeTeam": {                "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                "name": "Lugo / Ramirez"              },              "awayTeam": {                "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                "name": "Lugo / Ramirez"              },              "winner": {                "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                "name": "Lugo / Ramirez"              },              "court": {                "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90",                "name": "Cancha 1",                "position": 1              },              "score": {                "idx": "f2a3b4c5-d6e7-4890-8f1a-2b3c4d5e6f70",                "home": 2,                "away": 1,                "playerPointsBalanced": null,                "sets": [                  {                    "idx": "e1f2a3b4-c5d6-4789-8e0f-1a2b3c4d5e6f",                    "home": 6,                    "away": 4,                    "number": 1,                    "isTieBreak": false                  }                ]              }            }          ],          "draws": [            {              "idx": "f8a9b0c1-d2e3-4456-8f70-819203142536",              "placement": 1,              "rounds": [                {                  "idx": "e7f8a9b0-c1d2-4345-8e6f-708192031425",                  "label": "Semifinal",                  "order": 2,                  "games": [                    {                      "idx": "a3b4c5d6-e7f8-4901-8a2b-3c4d5e6f7081",                      "number": 7,                      "displayNumber": 7,                      "status": "FINISHED",                      "time": "2026-09-12T16:00:00.000Z",                      "lengthInMinutes": 90,                      "courtNumber": 2,                      "matchDay": 1,                      "roundDetail": "Grupo A",                      "scheduleNumber": 14,                      "sectionNumber": 1,                      "isRetirement": false,                      "retiredTeamId": null,                      "liveStartedAt": null,                      "resultApprovalStatus": "PENDING",                      "submittedAt": null,                      "homeTeamDetails": {                        "label": "Del juego 3",                        "teamNumber": 2,                        "poolNumber": 1,                        "poolRank": 1,                        "sourceGameNumber": 3,                        "sourceResult": "WINNER"                      },                      "awayTeamDetails": {                        "label": "Del juego 3",                        "teamNumber": 2,                        "poolNumber": 1,                        "poolRank": 1,                        "sourceGameNumber": 3,                        "sourceResult": "WINNER"                      },                      "createdAt": "2026-08-20T11:02:00.000Z",                      "homeTeam": {                        "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                        "name": "Lugo / Ramirez"                      },                      "awayTeam": {                        "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                        "name": "Lugo / Ramirez"                      },                      "winner": {                        "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",                        "name": "Lugo / Ramirez"                      },                      "court": {                        "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90",                        "name": "Cancha 1",                        "position": 1                      },                      "score": {                        "idx": "f2a3b4c5-d6e7-4890-8f1a-2b3c4d5e6f70",                        "home": 2,                        "away": 1,                        "playerPointsBalanced": null,                        "sets": [                          {                            "idx": "e1f2a3b4-c5d6-4789-8e0f-1a2b3c4d5e6f",                            "home": 6,                            "away": 4,                            "number": 1,                            "isTieBreak": false                          }                        ]                      }                    }                  ]                }              ]            }          ]        }      ],      "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          }        }      ],      "circuitCategory": {        "idx": "b2c3d4e5-f6a7-4890-8b1c-2d3e4f5a6b7c",        "name": "Primera Fuerza",        "gender": "MIXED",        "color": "#1E3A8A"      }    }  ],  "sponsors": [    {      "idx": "d4e5f6a7-b8c9-4012-8345-6789abcdef01",      "name": "Bebidas del Valle",      "logoUrl": "https://cdn.setto.io/sponsors/bebidas-del-valle.png",      "websiteUrl": "https://bebidasdelvalle.mx",      "description": "Patrocinador oficial de hidratacion",      "position": 1    }  ],  "circuit": {    "idx": "a1b2c3d4-e5f6-4789-8a0b-1c2d3e4f5a6b",    "name": "Circuito Nacional de Padel",    "slug": "circuito-nacional-de-padel",    "seasonYear": 2026  },  "circuitCategory": {    "idx": "b2c3d4e5-f6a7-4890-8b1c-2d3e4f5a6b7c",    "name": "Primera Fuerza",    "gender": "MIXED",    "color": "#1E3A8A"  },  "rankedTiebreakRules": [    {      "idx": "d4e5f6a7-b8c9-4012-8d3e-4f5a6b7c8d9e",      "rank": 1,      "rule": {        "idx": "c3d4e5f6-a7b8-4901-8c2d-3e4f5a6b7c8d",        "name": "Head to head",        "acronym": "H2H"      }    }  ]}