get_schedule

2 creditsBasic lookupPOST /v1/get_schedule

Upcoming and in-progress matches for the next days

Use it when you want what is being played in the next few days, for a schedule screen or to queue lookups.

Parameters

daysintegeroptional: Days ahead (default 7).

Notes

Over MCP, ask for it in plain English and the client calls get_schedule itself. Point any MCP client at https://mcp.acesapi.com/mcp?key=YOUR_API_KEY.
Each call costs 2 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.acesapi.com/v1/get_schedule \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "days": 3
}'

Response

json

{
  "tour": "ATP",
  "days": 3,
  "matches": [
    {
      "match_id": "184857",
      "tournament_id": "315-2026",
      "tournament": "Rolex Shanghai Masters",
      "season": 2026,
      "surface": "hard",
      "indoor": null,
      "starts_at": "2026-10-08T04:05:00.000Z",
      "match_date": "2026-10-08",
      "draw": "main",
      "round": "Round 1",
      "round_order": 11,
      "court": "Court 4",
      "player1_id": "4115",
      "player1": "Nuno Borges",
      "player1_country": "POR",
      "seed1": null,
      "player2_id": "3694",
      "player2": "Facundo Diaz Acosta",
      "player2_country": "ARG",
      "seed2": null,
      "winner_id": null,
      "status": "live",
      "outcome": null,
      "score": null,
      "sets1": null,
      "sets2": null,
      "games1": null,
      "games2": null
    },
    {
      "match_id": "184874",
      "tournament_id": "315-2026",
      "tournament": "Rolex Shanghai Masters",
      "season": 2026,
      "surface": "hard",
      "indoor": null,
      "starts_at": "2026-10-08T04:05:00.000Z",
      "match_date": "2026-10-08",
      "draw": "main",
      "round": "Round 1",
      "round_order": 11,
      "court": "Show Court 3",
      "player1_id": "3572",
      "player1": "Pavel Kotov",
      "player1_country": "RUS",
      "seed1": null,
      "player2_id": "3319",
      "player2": "Tallon Griekspoor",
      "player2_country": "NED",
      "seed2": null,
      "winner_id": null,
      "status": "live",
      "outcome": null,
      "score": null,
      "sets1": null,
      "sets2": null,
      "games1": null,
      "games2": null
    },
    {
      "match_id": "184855",
      "tournament_id": "315-2026",
      "tournament": "Rolex Shanghai Masters",
      "season": 2026,
      "surface": "hard",
      "indoor": null,
      "starts_at": "2026-10-08T04:10:00.000Z",
      "match_date": "2026-10-08",
      "draw": "main",
      "round": "Round 1",
      "round_order": 11,
      "court": "Stadium Court",
      "player1_id": "2009",
      "player1": "Kimmer Coppejans",
      "player1_country": "BEL",
      "seed1": null,
      "player2_id": "2869",
      "player2": "Stefanos Tsitsipas",
      "player2_country": "GRE",
      "seed2": null,
      "winner_id": null,
      "status": "scheduled",
      "outcome": null,
      "score": null,
      "sets1": null,
      "sets2": null,
      "games1": null,
      "games2": null
    }
  ],
  "count": 66
}