← Back to API docs

GET/api/v1/data/delete/records

Get deleted records
Realtime data packageWorld Cup packageactivebetacoreAvailable

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

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

Real response with an external key at 09/11/2026, 14:28 UTC: HTTP 200, 160 rows, 145 ms (data cut to 2 rows)

{
  "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_atstringExample: "2026-11-05T09:41:04.72405Z"
entity_idstringExample: "1431"
entity_typestringExample: "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: 1793871664724

Errors

HTTPmessageWhen
401missing API key / unauthorizedNo X-API-Key, or the key is invalid or disabled
429rate limit exceeded / daily quota exceededThe key's per-minute rate or daily quota is exceeded
429server busy, retry laterThe server's concurrency slots are full (only 2 heavy requests at a time); retry after Retry-After seconds
500query errorThe query failed on the server; you may retry