GET/api/v1/teams/detail

Get team details

World Cup packageactivebetacoreAvailable (scoped)

Description

Returns the data for the given team id (suggested rate: up to 60 requests/min)

Access

Request: GET https://api.sports.csap.ai/api/v1/teams/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/teams/detail" \
  -H "X-API-Key: YOUR_API_KEY"

Try it

Example response

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

{
  "code": 0,
  "data": [
    {
      "coach_id": null,
      "competition_id": null,
      "country": null,
      "country_id": null,
      "country_logo": null,
      "country_zh": null,
      "disband_time": null,
      "foreign_players": null,
      "foundation_time": null,
      "founded": null,
      "gender": null,
      "id": 5411,
      "logo": "http://43.99.60.51:8080/logos/bd36e327173040173825c20c8a1cc39d7d3d6c3d23b134ebc905d6af9860a8b1.png",
      "logo_hash": "c2cccf6b310944638dab9d9745c3cf11.png",
      "logo_url": "http://43.99.60.51:8080/logos/bd36e327173040173825c20c8a1cc39d7d3d6c3d23b134ebc905d6af9860a8b1.png",
      "market_value": null,
      "market_value_currency": null,
      "name_zh": "纳积兰",
      "name_zht": null,
      "national": null,
      "national_players": null,
      "short_name_zh": "纳积兰",
      "short_name_zht": null,
      "source": "S3",
      "source_id": "17989",
      "total_players": null,
      "uid": 5411,
      "updated_at": 1794226827607,
      "venue": null,
      "venue_id": null,
      "virtual": null,
      "website": null,
      "name": "Najran SC"
    },
    {
      "coach_id": null,
      "competition_id": null,
      "country": null,
      "country_id": null,
      "country_logo": null,
      "country_zh": null,
      "disband_time": null,
      "foreign_players": null,
      "foundation_time": null,
      "founded": null,
      "gender": null,
      "id": 5412,
      "logo": "http://43.99.60.51:8080/logos/186745e4e2b3eb10d82477be917071cf474e6468c46cbd279bff13e79414616e.png",
      "logo_hash": "cf55a82aa9160a67834c4eeda6f1e804.png",
      "logo_url": "http://43.99.60.51:8080/logos/186745e4e2b3eb10d82477be917071cf474e6468c46cbd279bff13e79414616e.png",
      "market_value": null,
      "market_value_currency": null,
      "name_zh": "祖布巴",
      "name_zht": null,
      "national": null,
      "national_players": null,
      "short_name_zh": "祖布巴",
      "short_name_zht": null,
      "source": "S3",
      "source_id": "18389",
      "total_players": null,
      "uid": 5412,
      "updated_at": 1794148998316,
      "venue": null,
      "venue_id": null,
      "virtual": null,
      "website": null,
      "name": "Jubbah"
    }
  ],
  "message": "success",
  "success": true
}

Response fields 34

coach_idnullnullableCoach id

competition_idnullnullableCompetition id

countrynullnullableCountry / region

country_idnullnullableCountry / region id

country_logonullnullableNational team logo (present for national teams)

country_zhnullnullableCountry / region Chinese name

disband_timenullnullableYear dissolved (returned when there is data)

foreign_playersnullnullableNumber of foreign players; -1 means no data for this field

foundation_timenullnullableFounding date

foundednullnullableYear founded

gendernullnullableGender

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

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

logo_hashstringnullableSHA-256 of the logo fileExample: "c2cccf6b310944638dab9d9745c3cf11.png"

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

market_valuenullnullableMarket value

market_value_currencynullnullableMarket value unit

name_enstringEnglish nameExample: "Najran SC"

name_zhstringChinese nameExample: "纳积兰"

name_zhtnullnullableTraditional Chinese name

nationalnullnullableNational team: 1 yes, 0 no

national_playersnullnullableNumber of national team players; -1 means no data for this field

short_name_ennullnullableEnglish short name

short_name_zhstringnullableChinese short nameExample: "纳积兰"

short_name_zhtnullnullableCantonese short name

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

source_idstringId within the sourceExample: "17989"

total_playersnullnullableTotal number of players; -1 means no data for this field

uidintegerUnique cursor id of the recordExample: 5411

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

venuenullnullableVenue

venue_idnullnullableVenue id

virtualnullnullablePlaceholder team: 1 yes, 0 no

websitenullnullableTeam website

Errors

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