Description
Returns season standings that changed in the last 10 minutes (full update)
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/matches/standing- 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 0
This endpoint takes no request parameters.
Example request
curl "https://api.sports.csap.ai/api/v1/matches/standing" \ -H "X-API-Key: YOUR_API_KEY"
Try it
Example response
{
"code": 0,
"data": [
{
"away_draw": 1,
"away_draws": 1,
"away_goal_diff": null,
"away_goals": 7,
"away_goals_against": 4,
"away_goals_for": 7,
"away_loss": 0,
"away_losses": 0,
"away_played": 3,
"away_points": 7,
"away_position": 1,
"away_rank": 1,
"away_total": 3,
"away_wins": 2,
"away_won": 2,
"color": null,
"comp_ref": "984",
"conference": null,
"deduct_points": null,
"draw": 2,
"draws": 2,
"goal_diff": 6,
"goals": 12,
"goals_against": 6,
"goals_for": 12,
"group": null,
"grp": null,
"home_draw": 1,
"home_draws": 1,
"home_goal_diff": null,
"home_goals": 5,
"home_goals_against": 2,
"home_goals_for": 5,
"home_loss": 0,
"home_losses": 0,
"home_played": 4,
"home_points": 10,
"home_position": 1,
"home_rank": 1,
"home_total": 4,
"home_wins": 3,
"home_won": 3,
"id": 1102,
"league": "Ligue 1",
"loss": 0,
"losses": 0,
"name_zh": null,
"name_zht": null,
"note": null,
"played": 7,
"points": 17,
"position": 1,
"promotion_id": null,
"promotions": null,
"rank": 1,
"rows": null,
"season_id": "99636",
"source": "S2",
"stage_id": "99636",
"tables": null,
"team_id": "148874",
"updated_at": 1793858002651,
"wins": 5,
"won": 5,
"name": "US Ben Guerdane"
},
{
"away_draw": 1,
"away_draws": 1,
"away_goal_diff": null,
"away_goals": 2,
"away_goals_against": 3,
"away_goals_for": 2,
"away_loss": 1,
"away_losses": 1,
"away_played": 3,
"away_points": 4,
"away_position": 4,
"away_rank": 4,
"away_total": 3,
"away_wins": 1,
"away_won": 1,
"color": null,
"comp_ref": "984",
"conference": null,
"deduct_points": null,
"draw": 1,
"draws": 1,
"goal_diff": 3,
"goals": 10,
"goals_against": 7,
"goals_for": 10,
"group": null,
"grp": null,
"home_draw": 0,
"home_draws": 0,
"home_goal_diff": null,
"home_goals": 8,
"home_goals_against": 4,
"home_goals_for": 8,
"home_loss": 0,
"home_losses": 0,
"home_played": 3,
"home_points": 9,
"home_position": 2,
"home_rank": 2,
"home_total": 3,
"home_wins": 3,
"home_won": 3,
"id": 1103,
"league": "Ligue 1",
"loss": 1,
"losses": 1,
"name_zh": null,
"name_zht": null,
"note": null,
"played": 6,
"points": 13,
"position": 2,
"promotion_id": null,
"promotions": null,
"rank": 2,
"rows": null,
"season_id": "99636",
"source": "S2",
"stage_id": "99636",
"tables": null,
"team_id": "59628",
"updated_at": 1793858002652,
"wins": 4,
"won": 4,
"name": "Espérance Sportive De Tunis"
}
],
"message": "success",
"success": true
}Response fields 65
away_drawintegernullableAway matches drawn
Example: 1away_drawsintegernullableAway draws
Example: 1away_goal_diffnullnullableAway goal difference
away_goalsintegernullableAway goals for
Example: 7away_goals_againstintegernullableAway goals against
Example: 4away_goals_forintegernullableAway goals for
Example: 7away_lossintegernullableAway matches lost
Example: 0away_lossesintegernullableAway losses
Example: 0away_playedintegernullableAway matches played
Example: 3away_pointsintegernullableAway points
Example: 7away_positionintegernullableAway rank
Example: 1away_rankintegernullableAway rank
Example: 1away_totalintegernullableAway matches
Example: 3away_winsintegernullableAway wins
Example: 2away_wonintegernullableAway matches won
Example: 2colornullnullableColour value
comp_refstringnullableCompetition id within the source
Example: "984"conferencenullnullableConference info (only a few competitions have it, e.g. MLS)
deduct_pointsnullnullablePoints deducted
drawintegernullableMatches drawn
Example: 2drawsintegernullableDraws
Example: 2goal_diffintegerGoal difference
Example: 6goalsintegerGoals
Example: 12goals_againstintegerGoals against
Example: 6goals_forintegerGoals
Example: 12groupstringnullableNon-zero means the group number in a group stage: 1 = A, 2 = B and so on
Example: "2026-27 English Premier League"grpstringnullableGroup
Example: "2026-27 English Premier League"home_drawintegernullableHome matches drawn
Example: 1home_drawsintegernullableHome draws
Example: 1home_goal_diffnullnullableHome goal difference
home_goalsintegernullableHome goals for
Example: 5home_goals_againstintegernullableHome goals against
Example: 2home_goals_forintegernullableHome goals for
Example: 5home_lossintegernullableHome matches lost
Example: 0home_lossesintegernullableHome losses
Example: 0home_playedintegernullableHome matches played
Example: 4home_pointsintegernullableHome points
Example: 10home_positionintegernullableHome rank
Example: 1home_rankintegernullableHome rank
Example: 1home_totalintegernullableHome matches
Example: 4home_winsintegernullableHome wins
Example: 3home_wonintegernullableHome matches won
Example: 3idintegerRecord id; paging cursor (the id parameter returns records >= this value). In match endpoints it is the platform match id (gmid)
Example: 1102leaguestringCompetition name (English)
Example: "Ligue 1"lossintegerMatches lost
Example: 0lossesintegerLosses
Example: 0name_enstringEnglish name
Example: "US Ben Guerdane"name_zhnullnullableChinese name
name_zhtnullnullableTraditional Chinese name
notenullnullableNote
playedintegerMatches played
Example: 7pointsintegerPoints
Example: 17positionintegerPosition
Example: 1promotion_idnullnullablePromotion / relegation id
promotionsnullnullablePromotion / relegation list
rankintegerRank
Example: 1rowsnullnullableTeam standings item
season_idstringnullableSeason id
Example: "99636"sourcestringSource code (S1, S2…)
Example: "S2"stage_idstringnullableId of the stage it belongs to
Example: "99636"tablesnullnullableStandings item
team_idstringTeam id
Example: "148874"updated_atintegerLast update time (UTC, ISO 8601; incremental sync with the time parameter goes by it)
Example: 1793858002651winsintegerWins
Example: 5wonintegerWins
Example: 5Errors
| 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 |