SETTO External API

The SETTO External API is an HTTP API over the SETTO tournaments you manage. With a personal API token you can read every tournament you manage, and with an organization API token every tournament of that organization — their categories (divisions), teams, rounds, groups, brackets, games and standings — and render them wherever you want; with a token that holds the «Gestionar torneos» permission you can also set tournaments up (create them and their categories, register teams, replace a player, withdraw a team) and set up each category's format, groups and knockout draw, with «Cargar resultados» record and clear game results, and with «Programar partidos» set when and on which court each game is played. There are 38 endpoints, all under /v1/external/. This page explains what the API covers and where to go next; the quickstart has a working request in under five minutes.

What you can read

What you can set up

With «Gestionar torneos» (manage); every path is under /v1/external.

Groups, draws and results

The three previews write nothing and need only «Leer» (read); results need «Cargar resultados» (results); applying a format, groups or a draw, «Confirmar cuadro» and every other action in this table need «Gestionar torneos» (manage). Every path is under /v1/external.

What you can schedule

That is the whole surface. Nothing else is written: the API cannot create or delete a single game, set up qualifiers or consolation games, delete a tournament or send an email, and no price, paid mark, payment record or refund changes (a withdrawal closes the team's unpaid payment links). Fútbol and league draws and results stay in the dashboard.

Who it is for

• Clubs and federations embedding live draws, schedules and standings on their own website.
• Sponsors and media partners pulling fixtures and results for a broadcast graphic or a newsletter.
• Analysts exporting a season into a spreadsheet or a database.
• AI agents — every page here is also served as Markdown, and there is an MCP server and an Agent Skill for the same 38 endpoints.

Base URL

https://api.setto.io/v1

Every path in this documentation is written in full (/v1/external/tournaments), so it appends directly to the host. api.setto.io is the canonical host; the Railway-generated host it replaced still answers, but new integrations should not use it.

Authentication in one line

Send your API token as a bearer token on every request:

GET /v1/external/tournaments HTTP/1.1
Host: api.setto.io
Authorization: Bearer setto_live_YOUR_TOKEN_HERE

Tokens are created in the SETTO organizer dashboard, in Configuración → Tokens de API. A token is personal (yours, reaching every tournament you manage) or an organization's (reaching only that organization's tournaments). See Authentication.

What the API never returns

The External API is designed to be safe to put in front of a public website. It never returns personal contact data (no emails, no phone numbers, no social handles) and never returns payment or billing data. Player objects carry only idx, firstName, lastName and avatar.

Two things it does return, which surprise people:

• Hidden divisions and rounds. They come back with isVisible: false instead of being dropped, so you decide whether to render them.
• Draft and archived tournaments. Filter them out with the status query parameter if you only want live ones.

Where to go next