---
title: "Upcoming WTA (women's tennis) matches with predictions"
method: GET
path: "/v1/predictions/wta/upcoming"
tags: ["predictions"]
---

# Upcoming WTA (women's tennis) matches with predictions

`GET /v1/predictions/wta/upcoming`

## Request

- Base URL: `https://api.predixsport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.predixsport.com/v1/predictions/wta/upcoming`
- Auth: none declared

Returns every WTA (women's tennis) match from the most recent WTA-pipeline run. Same semantics as the ATP ``tennis`` sport: the ``date`` field reflects the tournament's scheduled play-day rather than the actual calendar day a match is played, and isn't reliably updated when the tour reschedules a slot. Filtering on it produces false negatives, so this endpoint instead joins on ``MAX(current_date_time_search)`` — the timestamp of the latest pipeline run — and returns every row from it. The ``days`` query parameter is accepted for API backward-compatibility but is NOT applied: a single run already covers the active tournament's near future. Every WTA match — Grand Slams included — is best-of-three sets. Use ``/v1/predictions/wta/search`` for historical queries.

## Query parameters

- `limit` integer
- `days` integer: Look-ahead horizon in days. Defines the upper bound of the inclusive window ``[today, today + days]``. Default 7, max 60.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- WTAUpcomingResponse
  - `matches` WTAUpcomingMatch[], required
    - `match_id` string, required
    - `sport` 'wta'
    - `date` string, date, required: Tournament-scheduled START day, NOT the actual day of play. Shared by every match of the same tournament across all rounds. Do not interpret a value in the past as 'match already played' — tournaments typically run 7–14 days from this date.
    - `season` string, required
    - `tournament` TournamentInfo, required
      - `name` string, required
      - `location` string, required
      - `surface` string, required
      - `type` string, required: Tournament category (e.g. grand_slam, masters_1000, atp_250).
      - `round` integer, nullable: Numeric round identifier as recorded by the data pipeline (higher = later round).
    - `player_one` PlayerStats, required: Win-side projection for a tennis player.
      - `name` string, required
      - `win_probability` number, nullable: Probability of this player winning the match, in [0, 1].
    - `player_two` PlayerStats, required: Win-side projection for a tennis player.
      - `name` string, required
      - `win_probability` number, nullable: Probability of this player winning the match, in [0, 1].
    - `predicted_total_games` integer, nullable: Rounded mean of the Poisson total-games regressor. Use the match-detail endpoint for the un-rounded mean and the full distribution. Independent of the winner classifier.
    - `predicted_result` string, nullable: Player name predicted to win (winner classifier output).
  - `count` integer, required

## Other responses

- `422`: Validation Error

---

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