GET/api/v1/matches/season/best/lineups/detail

Get a season's teams of the round

World Cup packageactivebetacoreAvailable (scoped)

Description

Returns the teams of the round for the given season id (suggested rate: up to 60 requests/min)

Access

Request: GET https://api.sports.csap.ai/api/v1/matches/season/best/lineups/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
season_id	string	required		Query by season id

Example request

curl "https://api.sports.csap.ai/api/v1/matches/season/best/lineups/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, 341 rows, 263 ms (data cut to 2 rows)

{
  "code": 0,
  "data": [
    {
      "competition_id": "16",
      "details": null,
      "formation": "4-1-2-3",
      "location_x": null,
      "location_y": null,
      "name_zh": null,
      "player_id": "556866",
      "player_name": "Gregor Kobel",
      "position": "G",
      "rating": null,
      "season_id": "58210",
      "source": "S2",
      "stage_id": "58210",
      "team_id": null,
      "update_time": null,
      "updated_at": 1794214860293
    },
    {
      "competition_id": "16",
      "details": null,
      "formation": "4-1-2-3",
      "location_x": null,
      "location_y": null,
      "name_zh": null,
      "player_id": "913654",
      "player_name": "Pedro Porro",
      "position": "D",
      "rating": null,
      "season_id": "58210",
      "source": "S2",
      "stage_id": "58210",
      "team_id": null,
      "update_time": null,
      "updated_at": 1794214860299
    }
  ],
  "message": "success",
  "success": true
}

Response fields 17

competition_idstringCompetition idExample: "16"

detailsnullnullableLineup players

formationstringFormationExample: "4-1-2-3"

location_xnullnullablex coordinate, out of 100

location_ynullnullabley coordinate, out of 100

name_ennullnullableEnglish name

name_zhnullnullableChinese name

player_idstringPlayer idExample: "556866"

player_namestringPlayer nameExample: "Gregor Kobel"

positionstringPositionExample: "G"

ratingnullnullableRating

season_idstringSeason idExample: "58210"

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

stage_idstringStage idExample: "58210"

team_idnullnullableTeam id

update_timenullnullableData publication time

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

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