# Data for Tennis API Documentation

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.datafortennis.com/_mcp/server

## Docs

- [Tennis data, with explicit context](https://docs.datafortennis.com/start-here/overview.md): Historical singles and doubles through one canonical API.
- [Make your first reproducible query](https://docs.datafortennis.com/start-here/quickstart.md)
- [Live WebSocket quickstart](https://docs.datafortennis.com/start-here/live-web-socket-quickstart.md): Receive canonical singles match states and independently entitled ATP predictions through one V2 connection.
- [Authentication and request limits](https://docs.datafortennis.com/start-here/authentication-and-limits.md)
- [Service status and observed uptime](https://docs.datafortennis.com/start-here/service-status.md): Read current API, WebSocket and source checks without confusing availability with data coverage.
- [WebSocket reference](https://docs.datafortennis.com/web-socket-reference.md)
- [Entities, IDs and orientation](https://docs.datafortennis.com/data-model/entities-and-i-ds.md)
- [Releases and stable pagination](https://docs.datafortennis.com/data-model/releases-and-pagination.md)
- [Points, scores and statistics](https://docs.datafortennis.com/data-model/points-scores-and-statistics.md)
- [Coverage, enrichment and clocks](https://docs.datafortennis.com/data-model/coverage-and-time-evidence.md)
- [Challenger data](https://docs.datafortennis.com/data-model/challenger-data.md): Select Challenger history, inspect measured coverage and use the shared player registry.
- [Live revisions and prediction history](https://docs.datafortennis.com/data-model/live-revisions-and-prediction-history.md): Join match states, points and predictions by canonical IDs and measure observed pipeline delay.
- [Catalogue and player research](https://docs.datafortennis.com/workflows/catalogue-and-player-research.md)
- [Changes, retries and usage](https://docs.datafortennis.com/workflows/changes-and-retries.md)
- [Private canonical export jobs](https://docs.datafortennis.com/workflows/private-exports.md)
- [Local network environment](https://docs.datafortennis.com/workflows/local-network-environment.md)
- [Errors and troubleshooting](https://docs.datafortennis.com/workflows/errors-and-troubleshooting.md)
- [API reference](https://docs.datafortennis.com/api-reference.md)

## API Docs

- WebSocket reference > Live [live](https://docs.datafortennis.com/web-socket-reference/live/live.md)
- API reference [Discover recent ATP singles prediction matches](https://docs.datafortennis.com/api-reference/list-prediction-matches.md)
- API reference [Get latest ATP singles match probabilities](https://docs.datafortennis.com/api-reference/get-prediction.md)
- API reference [Download a bounded range of a private canonical artifact](https://docs.datafortennis.com/api-reference/download-export.md)
- API reference [Preview a private export](https://docs.datafortennis.com/api-reference/preview-export.md)
- API reference [Create a private export job](https://docs.datafortennis.com/api-reference/create-export.md)
- API reference [Get export status and manifest](https://docs.datafortennis.com/api-reference/get-export.md)
- API reference [Cancel a private export job](https://docs.datafortennis.com/api-reference/cancel-export.md)
- API reference [Resolve allowlisted scoped external identities](https://docs.datafortennis.com/api-reference/resolve-identity.md)
- API reference [Read points for multiple matches](https://docs.datafortennis.com/api-reference/batch-points.md)
- API reference [Read head-to-head results](https://docs.datafortennis.com/api-reference/get-h-2-h.md)
- API reference [List metric definitions](https://docs.datafortennis.com/api-reference/list-metrics.md)
- API reference [Read player-season aggregates](https://docs.datafortennis.com/api-reference/get-player-season.md)
- API reference [List changes at a pinned high water](https://docs.datafortennis.com/api-reference/list-changes.md)
- API reference [List available releases](https://docs.datafortennis.com/api-reference/list-releases.md)
- API reference [Get an immutable release](https://docs.datafortennis.com/api-reference/get-release.md)
- API reference [List draws](https://docs.datafortennis.com/api-reference/list-draws.md)
- API reference [Get a draw](https://docs.datafortennis.com/api-reference/get-draw.md)
- API reference [List players](https://docs.datafortennis.com/api-reference/list-players.md)
- API reference [Get a player profile](https://docs.datafortennis.com/api-reference/get-player.md)
- API reference [List a player's matches](https://docs.datafortennis.com/api-reference/list-player-matches.md)
- API reference [List matches](https://docs.datafortennis.com/api-reference/list-matches.md)
- API reference [Get a match and result](https://docs.datafortennis.com/api-reference/get-match.md)
- API reference [List match points](https://docs.datafortennis.com/api-reference/list-points.md)
- API reference [List match and set statistics](https://docs.datafortennis.com/api-reference/list-stats.md)
- API reference [Read release coverage](https://docs.datafortennis.com/api-reference/get-coverage.md)
- API reference [Read match coverage](https://docs.datafortennis.com/api-reference/get-match-coverage.md)
- API reference [Live](https://docs.datafortennis.com/api-reference/live.md)
- API reference [Ready](https://docs.datafortennis.com/api-reference/ready.md)
- API reference [Explicitly enabled aggregate coverage for a named release](https://docs.datafortennis.com/api-reference/get-coverage-summary.md)
- API reference [List dataset capabilities](https://docs.datafortennis.com/api-reference/list-datasets.md)
- API reference [List tournament series](https://docs.datafortennis.com/api-reference/list-tournaments.md)
- API reference [Get a tournament series](https://docs.datafortennis.com/api-reference/get-tournament.md)
- API reference [List tournament editions](https://docs.datafortennis.com/api-reference/list-editions.md)
- API reference [Get a tournament edition](https://docs.datafortennis.com/api-reference/get-edition.md)
- API reference [Point rally categories and reconstructed exact values](https://docs.datafortennis.com/api-reference/list-rally.md)
- API reference [Classified stroke outcome summaries, not shot sequences](https://docs.datafortennis.com/api-reference/list-strokes.md)
- API reference [Competing observed, relative and estimated clock evidence](https://docs.datafortennis.com/api-reference/list-time-evidence.md)
- API reference [Read retained immutable prediction history](https://docs.datafortennis.com/api-reference/list-prediction-history.md)
- API reference [Read an immutable prediction by its own ID](https://docs.datafortennis.com/api-reference/get-prediction-record.md)
- API reference [Discover tracked singles matches across admitted tours](https://docs.datafortennis.com/api-reference/list-live-matches.md)
- API reference [Read the current tracked match state](https://docs.datafortennis.com/api-reference/get-live-match.md)
- API reference [Read the latest versions of observed match points](https://docs.datafortennis.com/api-reference/list-live-points.md)
- API reference [Read observed lifecycle transitions without private commentary](https://docs.datafortennis.com/api-reference/list-live-status-history.md)
- API reference [Create a short lived WebSocket connection ticket](https://docs.datafortennis.com/api-reference/create-stream-ticket.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.datafortennis.com/openapi.json)
- [OpenAPI YAML](https://docs.datafortennis.com/openapi.yaml)


## AsyncAPI Specification

The raw AsyncAPI 2.6.0 specification for the WebSocket channels is available at:
- [AsyncAPI JSON](https://docs.datafortennis.com/asyncapi.json)
- [AsyncAPI YAML](https://docs.datafortennis.com/asyncapi.yaml)