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
| Data | Updates | Notes |
|---|---|---|
| Live scores | Within seconds of each point | REST and WebSocket. Free and Starter receive them 60 seconds late. |
| Completed results | As the match ends | Archived under the match id and added to both players' match logs and form. |
| Match and set statistics | Within hours of the match | Filled from the live feed and a statistics pass every 6 hours. |
| Upcoming fixtures | Every 10 minutes | About three days ahead; fixtures withdrawn from the draw are removed. |
| Rankings | Weekly | When the ATP and WTA publish, on Mondays. |
| ITF and junior results | Every 2 hours | |
| Historical archive | Corrections as they are proven | See 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/coverageDataset 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."
]
}