GET/api/v1/leagues/detail

Get competition details

World Cup packageactivebetacoreAvailable (scoped)

Description

Returns all competitions (suggested frequency: once a minute)

Access

Request: GET https://api.sports.csap.ai/api/v1/leagues/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 0

This endpoint takes no request parameters.

Example request

curl "https://api.sports.csap.ai/api/v1/leagues/detail" \
  -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, 1000 rows, 616 ms (data cut to 2 rows)

{
  "code": 0,
  "data": [
    {
      "category_id": "1",
      "category_name": "England",
      "city": null,
      "comp_id": "17",
      "competition_id": "17",
      "country": null,
      "country_id": null,
      "divisions": null,
      "end_time": null,
      "gender": null,
      "group_count": null,
      "has_player_stats": null,
      "has_table": null,
      "has_team_stats": null,
      "host": null,
      "id": 1,
      "is_current": null,
      "kind": null,
      "logo": "http://43.99.60.51:8080/logos/111451bfcfb3f00ac16f90d9240e175ce41561d85fd83baff92a4bcedd73d0a6.webp",
      "logo_hash": null,
      "logo_url": "http://43.99.60.51:8080/logos/111451bfcfb3f00ac16f90d9240e175ce41561d85fd83baff92a4bcedd73d0a6.webp",
      "mode": null,
      "most_titles": null,
      "name_zh": null,
      "name_zht": null,
      "newcomers": null,
      "order": null,
      "primary_color": null,
      "round_count": null,
      "rule": null,
      "season_id": null,
      "seasons": null,
      "secondary_color": null,
      "short_name_zh": null,
      "short_name_zht": null,
      "slug": "premier-league",
      "source": "S2",
      "stages": null,
      "start_time": null,
      "title_holder": null,
      "type": null,
      "uid": 1,
      "updated_at": 1794127801097,
      "user_count": 1186113,
      "year": null,
      "name": "Premier League"
    },
    {
      "category_id": "1",
      "category_name": "England",
      "city": null,
      "comp_id": "18",
      "competition_id": "18",
      "country": null,
      "country_id": null,
      "divisions": null,
      "end_time": null,
      "gender": null,
      "group_count": null,
      "has_player_stats": null,
      "has_table": null,
      "has_team_stats": null,
      "host": null,
      "id": 2,
      "is_current": null,
      "kind": null,
      "logo": "http://43.99.60.51:8080/logos/93688a52d86dca1ec1fbf0a2103ff23dfa2a6321dee0706fc96555355164416a.webp",
      "logo_hash": null,
      "logo_url": "http://43.99.60.51:8080/logos/93688a52d86dca1ec1fbf0a2103ff23dfa2a6321dee0706fc96555355164416a.webp",
      "mode": null,
      "most_titles": null,
      "name_zh": null,
      "name_zht": null,
      "newcomers": null,
      "order": null,
      "primary_color": null,
      "round_count": null,
      "rule": null,
      "season_id": null,
      "seasons": null,
      "secondary_color": null,
      "short_name_zh": null,
      "short_name_zht": null,
      "slug": "championship",
      "source": "S2",
      "stages": null,
      "start_time": null,
      "title_holder": null,
      "type": null,
      "uid": 2,
      "updated_at": 1794127801098,
      "user_count": 126287,
      "year": null,
      "name": "Championship"
    }
  ],
  "message": "success",
  "success": true
}

Response fields 47

category_idstringCategory idExample: "1"

category_namestringCategory nameExample: "England"

citynullnullableCity

comp_idstringCompetition idExample: "17"

competition_idstringCompetition idExample: "17"

countrynullnullableCountry / region

country_idnullnullableCountry / region id

divisionsnullnullableCompetition levels (absent when empty) · example: [[], [83]]

end_timenullnullableEnd time

gendernullnullableGender

group_countnullnullableTotal number of groups

has_player_statsnullnullableHas player statistics: 1 yes, 0 no

has_tablenullnullableHas standings: 1 yes, 0 no

has_team_statsnullnullableHas team statistics: 1 yes, 0 no

hostnullnullableHost (absent when empty)

idintegerRecord id; paging cursor (the id parameter returns records >= this value). In match endpoints it is the platform match id (gmid)Example: 1

is_currentnullnullableIs the latest season: 1 yes, 0 no

kindnullnullableKind

logostringLogo (image address on this platform; empty when there is none)

logo_hashnullnullableSHA-256 of the logo file

logo_urlstringLogo (image address on this platform; empty when there is none)

modenullnullableMatch mode: 1 league (points), 2 knockout

most_titlesnullnullableMost titles (absent when empty) · example: [[10135], 20]

name_enstringEnglish nameExample: "Premier League"

name_zhnullnullableChinese name

name_zhtnullnullableTraditional Chinese name

newcomersnullnullablePromoted and relegated teams (absent when empty) · example: [[10021], [10411]]

ordernullnullableOrder of the stage

primary_colornullnullablePrimary colour; may be absent

round_countnullnullableTotal number of rounds

rulenullnullableIntelligence

season_idnullnullableSeason id

seasonsnullnullableSeason details

secondary_colornullnullableSecondary colour; may be absent

short_name_ennullnullableEnglish short name

short_name_zhnullnullableChinese short name

short_name_zhtnullnullableCantonese short name

slugstringEnglish slug (for URLs)Example: "premier-league"

sourcestringSource code (S1, S2…)Example: "S2"

stagesnullnullableStage details

start_timenullnullableStart time

title_holdernullnullableTitle holder (absent when empty) · example: [10181, 6]

typenullnullableType

uidintegerUnique cursor id of the recordExample: 1

updated_atintegerLast update time (UTC, ISO 8601; incremental sync with the time parameter goes by it)Example: 1794127801097

user_countintegerExample: 1186113

yearnullnullableSeason year

Errors

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