Measured completeness rollup per tour × draw bucket (BASIC)

Requires BASIC on the live API, or any Historical Data API plan (Starter and up — see https://livetennisapi.com/historical-tennis-data-api). A FREE key may spend its 20 free history calls per calendar month here; past that the answer is 403 upgrade_required carrying free_history_taste: "used". The numbers to read BEFORE choosing what to backtest, in one call instead of paging the archive. A PREBUILT snapshot rebuilt nightly right after the completeness ledger reconverges — never computed at read time — so as_of (= built_at) dates every number, and ledger_max_computed_at is the newest underlying per-match measurement. Buckets are atp/wta/challenger/itf/juniors × singles/doubles plus other (team ties, mixed, exhibitions, and matches with no stated event type — counted, never dropped, so the totals cannot lie), derived from the same registries as the tour and draw fields. method states the full measurement rule in one paragraph, so every number carries its own definition. As of 2026-08-18 the headline spread it exposes: 51.1% of ITF singles matches are point-complete on the best basis against 3.5% of ITF doubles — do not extrapolate a completeness rate across a tour group.

get/history/coverage

Request

  • Base URL: https://api.livetennisapi.com/api/public/v1
  • URL: https://api.livetennisapi.com/api/public/v1/history/coverage
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Response

The rollup artifact, dated by its own as_of

as_ofstring date-time

Equal to built_at, verbatim — the artifact's own clock, and the date to quote with every number in this response.

built_atstring date-time

When the rollup was built (UTC).

ledger_max_computed_atstring date-time nullable

The newest underlying per-match measurement in the completeness ledger.

methodstring

The full measurement rule for point_complete, in one paragraph — every number carries its own definition.

bucketsobject

One CoverageBucket per tour × draw bucket (atp_singles … juniors_doubles, plus other). A bucket with zero completed matches is OMITTED rather than emitted as zeros — read a missing key as "nothing to count", not an error.

Changes

No recorded changes to this operation across all 1 revision of this API.