Coverage & updates

GET /tennis/coverage answers this live from the database, so the numbers below are what the API itself reports.

What is covered

  • ATP and WTA tour singles, Grand Slams and Challengers, with history back to 1968 (ATP records reach back further, to 1877).
  • ITF World Tennis Tour singles: men's M15 and M25, women's W15 to W100, under tour ATP and WTA.
  • Junior events, from the ITF and junior-slam feeds.
  • Live scores for tour, Challenger and ITF matches; doubles appear live only.
  • Weekly ATP and WTA singles rankings with point-in-time history, so you can ask where a player was ranked the week a match was played.
  • Not offered: bookmaker odds (pair the API with a licensed odds provider), college tennis, historical doubles.

How often each part updates

DataUpdatesNotes
Live scoresWithin seconds of each pointREST and WebSocket. Free and Starter receive them 60 seconds late.
Completed resultsAs the match endsArchived under the match id and added to both players' match logs and form.
Match and set statisticsWithin hours of the matchFilled from the live feed and a statistics pass every 6 hours.
Upcoming fixturesEvery 10 minutesAbout three days ahead; fixtures withdrawn from the draw are removed.
RankingsWeeklyWhen the ATP and WTA publish, on Mondays.
ITF and junior resultsEvery 2 hours
Historical archiveCorrections as they are provenSee data quality below.

Data quality

An automated monitor runs continuously over the data: every result must have two different players, a complete score for its outcome (a retirement is marked as one), and a winner consistent with the sets. ITF matches are checked against the ITF's own published draws and retirements against an independent results source; a proven correction is applied and journaled, and a row nothing can prove stays as it is rather than being guessed.

Endpoint

GET/tennis/coverage

Dataset Coverage

bash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.citoapi.com/api/v1/tennis/coverage"

Real response (HTTP 200), captured from the production API; long arrays cut to two items.

json
{
  "success": true,
  "tours": [
    {
      "tour": "WTA",
      "year_start": 1968,
      "year_end": 2026,
      "levels": [
        "Challenger",
        "Grand Slam"
      ],
      "tournament_editions": 25511
    },
    {
      "tour": "ATP",
      "year_start": 1877,
      "year_end": 2026,
      "levels": [
        "Challenger",
        "Grand Slam"
      ],
      "tournament_editions": 33039
    }
  ],
  "supported": {
    "singles": true,
    "doubles": "live_only",
    "live": true,
    "odds": true,
    "itf": true,
    "juniors": true,
    "college": false
  },
  "itf": {
    "ATP": {
      "events": 3305,
      "first_date": "2020-01-06",
      "last_date": "2026-10-02",
      "levels": [
        "15",
        "25"
      ]
    },
    "WTA": {
      "events": 13236,
      "first_date": "1994-01-31",
      "last_date": "2026-10-02",
      "levels": [
        "10",
        "15"
      ]
    },
    "filter": "?level=itf, or a prize level: 15, 25, M15, M25, W15, W35, W50, W75, W100",
    "note": "ITF World Tennis Tour singles. Men's events appear under tour ATP, women's under WTA."
  },
  "juniors": {
    "ATP": {
      "events": 4,
      "first_date": "2026-05-28",
      "last_date": "2026-09-12",
      "levels": [
        "J"
      ]
    },
    "WTA": {
      "events": 6,
      "first_date": "1969-02-13",
      "last_date": "2026-09-12",
      "levels": [
        "J"
      ]
    },
    "filter": "?level=junior",
    "note": "Junior Grand Slam singles (boys under ATP, girls under WTA). The weekly ITF junior circuit is not covered."
  },
  "college": {
    "teams": 0,
    "dual_matches": 0,
    "individual_matches": 0,
    "last_completed_dual_match": null,
    "routes": "/college/teams, /college/dual-matches, /college/matches, /college/players",
    "note": "US college tennis (NCAA Division I-III, NAIA, JUCO) team matches and individual results."
  },
  "doubles_detail": {
    "served": true,
    "live_board": true,
    "archived": false,
    "player_ids": false,
    "currently_live": 1,
    "note": "Doubles matches surface on /matches/live while in progress, as a single combined pair name with no per-partner player id. They are not archived: no doubles match history, stats, or head-to-head."
  },
  "updated_at": "2026-10-02T23:02:41.795279+00:00",
  "notes": [
    "Coverage is derived from currently loaded records.",
    "ITF and Challenger availability varies by source year."
  ]
}