---
title: "Get my ATP Fantasy roster, current board and latest advice"
method: GET
path: "/v1/fantasy/tennis/me"
tags: ["fantasy"]
---

# Get my ATP Fantasy roster, current board and latest advice

`GET /v1/fantasy/tennis/me`

## 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/fantasy/tennis/me`
- Auth: none declared

## Query parameters

- `season` string, nullable
- `board_limit` integer, nullable: Optional projection-board limit. The response reports total and omitted player counts when a bounded summary is requested.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- TennisFantasyStateResponse
  - `sport` 'tennis'
  - `roster` TennisFantasySavedRoster, required
    - `season` string, required
    - `roster` TennisFantasyRosterPlayer[], required
      - `name` string, required
      - `credits` integer, required
      - `locked` boolean
    - `budget_remaining` integer
    - `free_switches` integer
    - `max_extra_switches` integer
    - `chip_mode` 'none' | 'triple_bounce' | 'alternates' | 'swing_switch'
    - `bank_switches` boolean
    - `updated_at` string, date-time, required
  - `board` TennisFantasyBoard
    - `week_key` string, required
    - `open` boolean, required
    - `lock_date` string, date, nullable: First real tournament start date for this game week. The board fails closed when this date cannot be established.
    - `revision` string, nullable: Content revision of the canonical board used to detect advice that became stale after a same-day refresh.
    - `board_refs` TennisFantasyBoardReference[], required
      - `tournament` string, required
      - `run_date` string, required
      - `generated_at` string, required
    - `players` TennisFantasyBoardPlayer[], required
      - `name` string, required
      - `tournament` string, required
      - `credits_estimate` integer, required
      - `credits_as_of` string, nullable
      - `expected_points` number, required
      - `entered_this_week` boolean
      - `title_probability` number, nullable
      - `expected_wins` number, nullable
      - `expected_matches` number, nullable
      - `aces_per_match` number, nullable
      - `double_faults_per_match` number, nullable
      - `serve_profile_fallback` string, nullable
      - `advancement_points` number, required
      - `aces_points` number, nullable
      - `double_fault_points` number, nullable
      - `straight_sets_points` number, nullable
      - `straight_model_available` boolean, nullable
      - `upset_points` number, nullable
    - `total_player_count` integer, required
    - `omitted_player_count` integer
  - `latest_recommendation` TennisFantasyRecommendation
    - `snapshot_id` integer, required
    - `season` string, required
    - `week_key` string, required
    - `optimizer_version` string, required
    - `switches` integer, required
    - `players_out` string[], required
    - `players_in` string[], required
    - `active` string[], required
    - `alternates` string[], required
    - `captain` string, required
    - `expected_points` number, required
    - `net_expected_points` number, required
    - `expected_gain` number, required
    - `decision_gain` number, required
    - `credits_remaining_estimate` integer, required
    - `estimated_roster` TennisFantasyRosterPlayer[], required
      - `name` string, required
      - `credits` integer, required
      - `locked` boolean
    - `lineup` TennisFantasyRecommendationPlayer[]
      - `name` string, required
      - `tournament` string, required
      - `credits_estimate` integer, required
      - `credits_as_of` string, nullable
      - `expected_points` number, required
      - `entered_this_week` boolean
      - `title_probability` number, nullable
      - `expected_wins` number, nullable
      - `expected_matches` number, nullable
      - `aces_per_match` number, nullable
      - `double_faults_per_match` number, nullable
      - `serve_profile_fallback` string, nullable
      - `advancement_points` number, required
      - `aces_points` number, nullable
      - `double_fault_points` number, nullable
      - `straight_sets_points` number, nullable
      - `straight_model_available` boolean, nullable
      - `upset_points` number, nullable
      - `role` 'captain' | 'active' | 'alternate', required
      - `projected_lineup_points` number, required
    - `switch_options` TennisFantasySwitchOption[]
      - `switches` integer, required
      - `players_in` string[], required
      - `players_out` string[], required
      - `active` string[], required
      - `alternates` string[], required
      - `captain` string, required
      - `net_expected_points` number, required
      - `points_gain` number, required
      - `penalty` number, required
      - `credits_remaining` integer, required
      - `free_switches_left` integer, required
      - `recommended` boolean, required
      - `switch_reserve_cost` number, required
    - `incoming_prices_are_estimates` boolean
    - `price_checks` TennisFantasyPriceChecks: What to verify in the game before applying (added Oct 2026). ``budget_tight`` = the plan leaves fewer than ``safety_margin_credits`` unspent on estimated prices; ``safe_alternative`` is then the best plan that keeps the margin (absent when it is the same transfer).
      - `price_mismatches` TennisFantasyPriceMismatch[]
        - `name` string, required
        - `entered_credits` integer, required
        - `estimated_credits` integer, required
        - `estimated_as_of` string, nullable
      - `incoming_prices_as_of` string, nullable
      - `credits_remaining_at_estimates` integer, nullable
      - `safety_margin_credits` integer, required
      - `budget_tight` boolean, required
      - `safe_alternative` TennisFantasySafeAlternative
        - `switches` integer, required
        - `players_in` string[], required
        - `players_out` string[], required
        - `active` string[], required
        - `alternates` string[], required
        - `captain` string, required
        - `net_expected_points` number, required
        - `points_cost` number, required
        - `credits_remaining` integer, required
    - `created_at` string, date-time, 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)