← Back to API docs

GET/api/v1/team/summary

Team profile (honours, past squads, ability ratings)
Platform extensionsactivebetacoreAvailable

Access

Request
GET https://api.sports.csap.ai/api/v1/team/summary
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
AvailableAny valid API key can call this endpoint.
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 2

ParameterTyperequiredExampleDescription
gtidintegerrequired14143Platform team id (required)
limitintegeroptional2Number of list rows

Example request

curl "https://api.sports.csap.ai/api/v1/team/summary?gtid=14143&limit=2" \
  -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, 1 rows, 104 ms (data cut to 2 rows)

{
  "code": 0,
  "data": {
    "honors": [],
    "id": "14143",
    "lineup": [
      {
        "confirmed": true,
        "gpid": null,
        "is_substitute": false,
        "logo": null,
        "match_source": "S3",
        "name_zh": null,
        "player_name": "巴罗索",
        "position": null,
        "shirt_number": null,
        "side": "home"
      },
      {
        "confirmed": true,
        "gpid": null,
        "is_substitute": false,
        "logo": null,
        "match_source": "S3",
        "name_zh": null,
        "player_name": "B.马丁内斯",
        "position": null,
        "shirt_number": null,
        "side": "home"
      },
      {
        "confirmed": true,
        "gpid": null,
        "is_substitute": false,
        "logo": null,
        "match_source": "S3",
        "name_zh": null,
        "player_name": "阿莱克斯·佩雷斯",
        "position": null,
        "shirt_number": null,
        "side": "home"
      }
    ],
    "lineup_match_id": 5179,
    "teams": [
      {
        "country": null,
        "country_zh": null,
        "founded": null,
        "logo_hash": "9f1c5e2a38fcfdc7f501275aafb41053.png",
        "name_zh": "皇家马德里C队",
        "name_zht": null,
        "short_name_zh": "皇家马德里C队",
        "source": "S3",
        "updated_at": "2026-11-07T15:55:32.360346Z",
        "venue": null,
        "name": "Real Madrid C"
      }
    ]
  },
  "message": "success",
  "success": true
}

Response fields 5

honorsarray
idstringRecord id; paging cursor (the id parameter returns records >= this value). In match endpoints it is the platform match id (gmid)Example: "14143"
lineuparray<object>· 12
lineup_match_idintegerExample: 5179
teamsarray<object>· 12

Errors

HTTPmessageWhen
401missing API key / unauthorizedNo X-API-Key, or the key is invalid or disabled
429rate limit exceeded / daily quota exceededThe key's per-minute rate or daily quota is exceeded
429server busy, retry laterThe server's concurrency slots are full (only 2 heavy requests at a time); retry after Retry-After seconds
500query errorThe query failed on the server; you may retry