---
title: "Tournament"
method: POST
path: "/v1/get_tournament"
tags: ["Basic lookup"]
---

# Tournament

`POST /v1/get_tournament`

## Request

- Base URL: `https://mcp.acesapi.com`
- URL: `https://mcp.acesapi.com/v1/get_tournament`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use for a tournament's draw and results: every singles match of one edition grouped by round in draw order (qualifying, then the main draw to the final), each with the score by set and tiebreak points, seeds, and the champion and runner-up. draw: main (default), qualifying or all. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits.

## Request body

- object
  - `tournament_id` string, required: Tournament edition id from list_tournaments, e.g. "188-2025".
  - `draw` 'main' | 'qualifying' | 'all': Which draw (default main).
  - `league` 'tennis' | 'wta': League. Defaults to tennis. One of: tennis, wta.

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `tour` string, required
    - `tournament` object, required
    - `champion` object, nullable, required
    - `runner_up` object, nullable, required
    - `rounds` object[], required
    - `count` number, required

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

[API](https://skmtc.dev/acesapi/apis/acesapi-api.md) · [All operations](https://skmtc.dev/acesapi/apis/acesapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/acesapi/apis/acesapi-api/revisions/01a182013f8b?raw)