SETTO API

One round by identifier, with its pools, games and draws

GET
/v1/external/rounds/{idx}

A round whose tournament belongs to another organization is a 404. populate is a comma-separated list of relation paths. Allowed: division, pools, pools.teams, pools.standings, pools.standings.team, pools.standings.teamStats, games, games.homeTeam, games.awayTeam, games.winner, games.court, games.score, games.score.sets, draws, draws.rounds, draws.rounds.games, draws.rounds.games.homeTeam, draws.rounds.games.awayTeam, draws.rounds.games.winner, draws.rounds.games.court, draws.rounds.games.score, draws.rounds.games.score.sets. Default when omitted: pools, pools.teams, games, games.homeTeam, games.awayTeam, games.winner, division, draws.rounds, draws.rounds.games, draws.rounds.games.homeTeam, draws.rounds.games.awayTeam, draws.rounds.games.winner, draws.rounds.games.score, draws.rounds.games.score.sets. 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

Round identifier

Formatuuid

Query Parameters

populate?string

Comma-separated. Allowed: division, pools, pools.teams, pools.standings, pools.standings.team, pools.standings.teamStats, games, games.homeTeam, games.awayTeam, games.winner, games.court, games.score, games.score.sets, draws, draws.rounds, draws.rounds.games, draws.rounds.games.homeTeam, draws.rounds.games.awayTeam, draws.rounds.games.winner, draws.rounds.games.court, draws.rounds.games.score, draws.rounds.games.score.sets

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/external/rounds/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "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                  }                ]              }            }          ]        }      ]    }  ]}