Description
Returns the ids of data deleted in the last 24 hours (matches, teams, players, coaches, competitions, seasons, stages); sync it on a schedule.
Suggested frequency: once every 1 to 5 minutes
Suggested frequency: once every 1 to 5 minutes
Access
- Request
GET https://api.sports.csap.ai/api/v1/data/delete/records- Auth
- Header X-API-Key: <your key> (Authorization: Bearer <key> also works; ?key= is still accepted but discouraged, because the key ends up in URLs and logs)
- External keys
- AvailableAny valid API key can call this endpoint.
- Rate limits
- 3000 per minute · 200000 per day · Set per key (rate_per_min and quota_daily returned by /api/v1/account are authoritative; the numbers above are a trial key's). Beyond them the answer is 429. In addition, heavy requests such as whole-table snapshots and statistics lists without a match id are processed 2 at a time for the whole platform; a request that cannot get a slot receives 429 with Retry-After. Responses do not carry X-RateLimit-* headers for now. See the general guide
Request parameters 0
This endpoint takes no request parameters.
Example request
curl "https://api.sports.csap.ai/api/v1/data/delete/records" \ -H "X-API-Key: YOUR_API_KEY"
Try it
Example response
{
"code": 0,
"data": [
{
"coach": null,
"competition": null,
"deleted_at": "2026-11-05T09:41:04.72405Z",
"entity_id": "1431",
"entity_type": "match",
"match": null,
"player": null,
"season": null,
"stage": null,
"team": null,
"updated_at": 1793871664724
},
{
"coach": null,
"competition": null,
"deleted_at": "2026-11-05T09:41:04.72405Z",
"entity_id": "1734",
"entity_type": "match",
"match": null,
"player": null,
"season": null,
"stage": null,
"team": null,
"updated_at": 1793871664724
}
],
"message": "success",
"success": true
}Response fields 11
coachnullnullableThe field is absent when there is no data · example: [0]
competitionnullnullableCompetition
deleted_atstring
Example: "2026-11-05T09:41:04.72405Z"entity_idstring
Example: "1431"entity_typestring
Example: "match"matchnullnullableThe field is absent when there is no data · example: [0]
playernullnullablePlayer name
seasonnullnullableSeason
stagenullnullableThe field is absent when there is no data · example: [0]
teamnullnullableTeam name
updated_atintegerLast update time (UTC, ISO 8601; incremental sync with the time parameter goes by it)
Example: 1793871664724Errors
| HTTP | message | When |
|---|---|---|
| 401 | missing API key / unauthorized | No X-API-Key, or the key is invalid or disabled |
| 429 | rate limit exceeded / daily quota exceeded | The key's per-minute rate or daily quota is exceeded |
| 429 | server busy, retry later | The server's concurrency slots are full (only 2 heavy requests at a time); retry after Retry-After seconds |
| 500 | query error | The query failed on the server; you may retry |