Description
Returns the injuries and suspensions for the given team id (suggested rate: up to 60 requests/min)
Access
- Request
GET https://api.sports.csap.ai/api/v1/players/missing/detail- 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
- Available (scoped)External keys can call it, but only data inside the open scope is returned.
- 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 1
| Parameter | Type | required | Example | Description |
|---|---|---|---|---|
| ids | string | required | Several ids, comma separated, 200 at most |
Example request
curl "https://api.sports.csap.ai/api/v1/players/missing/detail" \ -H "X-API-Key: YOUR_API_KEY"
Try it
Example response
{
"code": 0,
"data": [
{
"competition": "england-championship",
"competition_id": null,
"end_time": null,
"id": 1,
"injury": null,
"kind": "injuries",
"missed_matches": null,
"player_id": null,
"player_zh": null,
"reason": null,
"return_date": null,
"source": "S13",
"start_time": null,
"status": "doubtful",
"team": "Birmingham",
"type": null,
"updated_at": 1793888012855,
"player": "Marc Leonard"
},
{
"competition": "england-championship",
"competition_id": null,
"end_time": null,
"id": 2,
"injury": null,
"kind": "injuries",
"missed_matches": null,
"player_id": null,
"player_zh": null,
"reason": null,
"return_date": "2026-11-15",
"source": "S13",
"start_time": null,
"status": "injured",
"team": "Blackburn",
"type": null,
"updated_at": 1793888012860,
"player": "Lewis Miller"
}
],
"message": "success",
"success": true
}Response fields 18
competitionstringCompetition
Example: "england-championship"competition_idnullnullableCompetition id
end_timenullnullableEnd time
idintegerRecord id; paging cursor (the id parameter returns records >= this value). In match endpoints it is the platform match id (gmid)
Example: 1injurynullnullableTeam injuries and suspensions list
kindstringKind
Example: "injuries"missed_matchesnullnullableMatches missed
player_enstringPlayer's English name
Example: "Marc Leonard"player_idnullnullablePlayer id
player_zhnullnullablePlayer's Chinese name
reasonnullnullableReason
return_datestringnullableExpected return date
Example: "2026-11-15"sourcestringSource code (S1, S2…)
Example: "S13"start_timenullnullableStart time
statusstringMatch status
Example: "doubtful"teamstringTeam name
Example: "Birmingham"typenullnullableType
updated_atintegerLast update time (UTC, ISO 8601; incremental sync with the time parameter goes by it)
Example: 1793888012855Errors
| HTTP | message | When |
|---|---|---|
| 401 | missing API key / unauthorized | No X-API-Key, or the key is invalid or disabled |
| 400 | bad param … | Malformed parameter (e.g. id is neither a number nor u<uid>) |
| 301 | match merged into <gmid> | Queried by an old match id that has been merged into a new gmid: Location points to the new address and the body carries moved_to |
| 404 | not found | The match / team / competition does not exist, or is outside what this key can see (external keys see only matches inside the open coverage) |
| 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 |