GET/api/v1/live

Live scoreboard

Realtime data packageactivebetacoreAvailable (scoped)

Access

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

Parameter	Type	required	Example	Description
competition	string	optional		Filter by competition name (fuzzy)
gcid	integer	optional	`287`	Platform competition id
limit	integer	optional	`2`	Number of rows, default 50, maximum 500

Example request

curl "https://api.sports.csap.ai/api/v1/live?limit=2" \
  -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, 2 rows, 98 ms (data cut to 2 rows)

{
  "code": 0,
  "data": [
    {
      "away_corner": 4,
      "away_gtid": 7190,
      "away_logo": "http://43.99.60.51:8080/logos/f6308f1df4bfc089793dd452628bc5f37bf2d6e80d63f884e8457560f5f66468.png",
      "away_red": 0,
      "away_score": 1,
      "away_team": "GS Niki Volou",
      "away_yellow": 1,
      "away_zh": "尼基沃罗",
      "comp_logo": "http://43.99.60.51:8080/logos/6e8ccfeeed779ad0cec7fd44afad84a534a4ec3d80d32337d73247220a58f119.png",
      "cur_period_start": 1794232786,
      "gcid": 736,
      "gmid": "6838",
      "half_away": 0,
      "half_home": 0,
      "home_corner": 7,
      "home_gtid": 7189,
      "home_logo": "http://43.99.60.51:8080/logos/6d285015517474f8c1a8e872fee94d872f55f0330fb553aac7719978698b78a4.png",
      "home_red": 0,
      "home_score": 0,
      "home_team": "APS Zakynthos 1961",
      "home_yellow": 1,
      "home_zh": "扎金索斯",
      "id": "6838",
      "league": "Superbet League 2",
      "league_zh": "希腊甲",
      "match_time": "2026-11-09T13:00:00Z",
      "minute": "75",
      "period_initial": 2700,
      "sources": "S5,S9,S4,S3,S2,S7",
      "start_ts": "2026-11-09T13:00:00Z",
      "status": "inprogress",
      "status_id": 4,
      "updated_at": "2026-11-09T14:28:42.226675Z"
    },
    {
      "away_corner": 0,
      "away_gtid": 3544,
      "away_logo": "http://43.99.60.51:8080/logos/2c16d31304410421c146eabbba52fcf46b2c20e8bc5cfb5c9c8a7d58f89d9892.webp",
      "away_red": 0,
      "away_score": 0,
      "away_team": "Palayesh Naft Bandar Abbas FC",
      "away_yellow": 0,
      "away_zh": "阿巴斯港石油",
      "comp_logo": "http://43.99.60.51:8080/logos/c9b7afcc9db847eb44761dbadee0fd93de78ff6be7a74e0abc0d39a3ba4a2234.png",
      "cur_period_start": 1794233880,
      "gcid": 1463,
      "gmid": "4130",
      "half_away": 0,
      "half_home": 2,
      "home_corner": 0,
      "home_gtid": 3543,
      "home_logo": "http://43.99.60.51:8080/logos/41dec58589c6edfb9419e8245820f4cdab184b7789ade7f8b6daaecc6545a3a4.webp",
      "home_red": 0,
      "home_score": 2,
      "home_team": "Pars Jonoubi Jam",
      "home_yellow": 0,
      "home_zh": "帕尔斯布什尔",
      "id": "4130",
      "league": "Azadegan League",
      "league_zh": "伊朗甲",
      "match_time": "2026-11-09T13:15:00Z",
      "minute": "56",
      "period_initial": 2700,
      "sources": "S5,S9,S4,S3,S2,S7",
      "start_ts": "2026-11-09T13:15:00Z",
      "status": "inprogress",
      "status_id": 4,
      "updated_at": "2026-11-09T14:28:40.22281Z"
    }
  ],
  "message": "success",
  "success": true
}

Response fields 33

away_cornerintegerAway team cornersExample: 4

away_gtidintegerPlatform team id of the away teamExample: 7190

away_logostringAway team logo (image address on this platform)

away_redintegerAway team red cardsExample: 0

away_scoreintegerAway team score (regular time, including stoppage time)Example: 1

away_teamstringAway team name (English)Example: "GS Niki Volou"

away_yellowintegerAway team yellow cardsExample: 1

away_zhstringAway team Chinese nameExample: "尼基沃罗"

comp_logostringCompetition logo (image address on this platform)

cur_period_startintegerStart of the current period (Unix seconds)Example: 1794232786

gcidintegerPlatform competition idExample: 736

gmidstringPlatform match id (gmid, unique across the platform)Example: "6838"

half_awayintegerAway team half-time scoreExample: 0

half_homeintegerHome team half-time scoreExample: 0

home_cornerintegerHome team cornersExample: 7

home_gtidintegerPlatform team id of the home teamExample: 7189

home_logostringHome team logo (image address on this platform; empty when there is none)

home_redintegerHome team red cardsExample: 0

home_scoreintegerHome team score (regular time, including stoppage time)Example: 0

home_teamstringHome team name (English)Example: "APS Zakynthos 1961"

home_yellowintegerHome team yellow cardsExample: 1

home_zhstringHome team Chinese nameExample: "扎金索斯"

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

leaguestringCompetition name (English)Example: "Superbet League 2"

league_zhstringCompetition Chinese nameExample: "希腊甲"

match_timestringKick-off time (UTC, ISO 8601)Example: "2026-11-09T13:00:00Z"

minutestringMatch minuteExample: "75"

period_initialintegerMinute at which the current period startsExample: 2700

sourcesstringSource codes of this merged record (comma separated)Example: "S5,S9,S4,S3,S2,S7"

start_tsstringKick-off time (UTC, ISO 8601)Example: "2026-11-09T13:00:00Z"

statusstringMatch statusExample: "inprogress"

status_idintegerMatch status code (see the status and type code table)Example: 4

updated_atstringLast update time (UTC, ISO 8601; incremental sync with the time parameter goes by it)Example: "2026-11-09T14:28:42.226675Z"

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