SETTO API

A tournament's schedule: courts, categories, every game, approved petitions

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

Everything an agent needs to plan or check a schedule, in one call. games lists every game, scheduled or not, with its court, start, length and locked (a locked game can no longer be moved). petitions lists APPROVED schedule petitions only: a CANNOT_PLAY window is never broken, a PREFERS window is a wish. date and HH:mm values are wall clock in tournament.timezone; startTime values are instants. A tournament outside the token’s reach is a 404. All identifiers (idx) are v4 UUIDs.

Authorization

apiToken
AuthorizationBearer <token>

API token (organization or personal)

In: header

Path Parameters

idx*string

Tournament identifier

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/schedule"
{  "tournament": {    "idx": "7c9e6679-7425-40de-944b-e07fc1f90ae7",    "name": "Padel Power Cup",    "timezone": "America/Mexico_City",    "startDate": "2026-11-07T00:00:00.000Z",    "endDate": "2026-11-08T00:00:00.000Z",    "scheduleType": "ASSIGNED"  },  "courts": [    {      "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90",      "name": "Cancha 1",      "position": 1    }  ],  "divisions": [    {      "idx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b",      "name": "Primera Varonil",      "color": "#1E3A8A"    }  ],  "games": [    {      "idx": "d0e1f2a3-b4c5-4678-9d0e-1f2a3b4c5d6e",      "number": 3,      "status": "UPCOMING",      "division": {        "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90"      },      "round": {        "idx": "3f1a2b3c-4d5e-4f60-8123-456789abcdef",        "type": "ROUND_ROBIN_ROUND"      },      "pool": "Grupo A",      "homeTeam": {        "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",        "name": "Lugo / Ramirez"      },      "awayTeam": {        "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c",        "name": "Lugo / Ramirez"      },      "startTime": "2026-11-07T15:00:00.000Z",      "lengthInMinutes": 60,      "court": {        "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90"      },      "locked": false    }  ],  "petitions": [    {      "team": {        "idx": "0f3a8c1e-59d4-4b2a-9c77-1b8e2d4f6a90"      },      "type": "CANNOT_PLAY",      "date": "2026-11-07",      "startTime": "16:00",      "endTime": "20:00"    }  ]}