---
title: "Match"
method: POST
path: "/v1/get_match"
tags: ["Basic lookup"]
---

# Match

`POST /v1/get_match`

## Request

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

Use for everything about one match: the score by set with tiebreak points, seeds, each player's sets, games and tiebreaks won, both players' ratings before and after (overall and on the surface), what the score says (total games, tiebreaks, whether it went the distance, comebacks), and each sportsbook's opening and closing moneylines where the match had them (Grand Slam, ATP Masters and WTA 1000 matches only). No serve statistics: they are not available. Tour: atp (default) or wta; on the shared endpoint pass league: "wta" for the WTA. Costs 2 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

## Request body

- object
  - `match_id` string, required: Match id from get_tournament, get_matches or get_player_matches.
  - `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
    - `match` object, required
    - `players` object[], required
    - `stats` object, required
    - `odds` object[], 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)