Listar equipos

GET /v1/external/tournaments/{idx}/teams lista cada inscripción registrada en un torneo — una pareja en dobles, un jugador único en singles, una escuadra en una liga por equipos. Cada equipo lleva su siembra, su categoría y (populados por defecto) sus jugadores. Úsalo para una lista de inscritos, una hoja de siembra, o para resolver las referencias { idx, name } de equipo que aparecen dentro de los payloads de ronda.

Igual que las categorías, la respuesta es un arreglo JSON pelón y no está paginada.

Petición

GET /v1/external/tournaments/3c9b7f52-6d41-4a8e-b1f0-2e7d5c9a4b18/teams?division=7b2f4d16-9c83-4e50-a7d1-3f6c8b204e59 HTTP/1.1
Host: api.setto.io
Authorization: Bearer setto_live_…

Parámetros

curl -s -G \
  https://api.setto.io/v1/external/tournaments/3c9b7f52-6d41-4a8e-b1f0-2e7d5c9a4b18/teams \
  -H "Authorization: Bearer $SETTO_API_TOKEN" \
  -d division=7b2f4d16-9c83-4e50-a7d1-3f6c8b204e59 \
  -d populate=playerProfiles,division

Respuesta

[
  {
    "idx": "e0c4b839-2d17-4a56-9fb3-6e8d1c05a274",
    "name": "Álvarez / Peña",
    "seed": 1,
    "seedNumber": 1,
    "club": "Club Padel Monterrey",
    "picture": null,
    "ranking": 412,
    "isWildCard": false,
    "qualifierStatus": null,
    "drawAssignment": null,
    "createdAt": "2026-08-14T15:02:31.770Z",
    "division": {
      "idx": "7b2f4d16-9c83-4e50-a7d1-3f6c8b204e59",
      "name": "Cuarta Fuerza Varonil"
    },
    "players": [
      {
        "idx": "f3a7d02c-8b19-4e65-97c4-5d1b0a6e3f82",
        "firstName": "Mariana",
        "lastName": "Álvarez",
        "avatar": "https://cdn.setto.io/avatars/f3a7d02c.jpg"
      },
      {
        "idx": "0d6c81b4-72ef-4a30-8b19-c5e73f2a9d64",
        "firstName": "Sofía",
        "lastName": "Peña",
        "avatar": null
      }
    ]
  },
  {
    "idx": "b71f3a05-6c28-49ed-8a94-2f5b0d7e1c63",
    "name": "Ramos / Ortega",
    "seed": null,
    "seedNumber": null,
    "isWildCard": true,
    "createdAt": "2026-08-19T11:47:03.214Z",
    "division": {
      "idx": "7b2f4d16-9c83-4e50-a7d1-3f6c8b204e59",
      "name": "Cuarta Fuerza Varonil"
    },
    "players": [
      {
        "idx": "6a2e9f47-0c53-4b81-9d26-8f1c4a7b0e35",
        "firstName": "Daniela",
        "lastName": "Ramos",
        "avatar": null
      },
      {
        "idx": "c94b7d18-3e60-4a27-85f9-2b0d6e1a7c84",
        "firstName": "Regina",
        "lastName": "Ortega",
        "avatar": null
      }
    ]
  }
]

Consejos y trampas

• playerProfiles se incrusta como players. La clave de populate y la clave de la respuesta son distintas. Igualmente captainProfile se incrusta como captainProfileIdx — un id, no un objeto.
• Los jugadores no llevan datos de contacto, por diseño. idx, firstName, lastName, avatar — ese es todo el objeto de jugador. No hay correo, teléfono ni redes sociales en la API externa.
• El orden es seed ascendente, los no sembrados al final, y luego name. No supongas que teams[0] es el primer sembrado si el organizador todavía no siembra el cuadro.
• Las categorías de singles también devuelven "equipos" con una sola entrada en players. Revisa division.isDoubles — de listDivisions — si necesitas etiquetarlos distinto.
• division puede ser null en un equipo que todavía no se asigna a una categoría.
• Usa el filtro division, no el filtrado del lado del cliente, en torneos grandes: se aplica en la consulta.
• Ligas por equipos: popula leagueTeam para obtener la escuadra ({ idx, name, color, logo, position, pointsAdjustment }) por la que juega cada inscripción.
• name es lo que renderizas. Es la etiqueta que el organizador eligió para la pareja y es lo que los payloads de ronda repiten en sus referencias { idx, name } de equipo, así que puedes mostrar los huecos del cuadro sin volver a cruzar con esta lista.

Relacionado

• Listar categorías — obtén el idx de division por el que filtrar.
• Modelo de datos — la lista completa de campos.
• Referencia: listTeams.

Herramienta MCP: list_teams