---
title: "Get live scores for a specific league by ID"
method: GET
path: "/livescore/{leagueId}"
tags: ["V2 API Livescores"]
---

# Get live scores for a specific league by ID

`GET /livescore/{leagueId}`

## Request

- Base URL: `https://www.thesportsdb.com/api/v2/json`
- URL: `https://www.thesportsdb.com/api/v2/json/livescore/{leagueId}`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/thesportsdb/apis/thesportsdb-v2-api/docs/livescore/:leagueId/get.ts> (a function with typed inputs; its response is checked against the schema)

Show the current Livescores for a particular league by its unique ID.

## Path parameters

- `leagueId` integer, required

## Response `200`

List of live scores for the specified sport

- LiveScoreList
  - `livescore` object[]
    - `idLiveScore` string
    - `idEvent` string
    - `strSport` string
    - `idLeague` string
    - `strLeague` string
    - `idHomeTeam` string
    - `idAwayTeam` string
    - `strHomeTeam` string
    - `strAwayTeam` string
    - `strHomeTeamBadge` string, uri
    - `strAwayTeamBadge` string, uri
    - `intHomeScore` string
    - `intAwayScore` string
    - `intEventScore` string, nullable
    - `intEventScoreTotal` string, nullable
    - `strStatus` string: Current game status (e.g., "FT" for full-time)
    - `strProgress` string: Game progress or period
    - `strEventTime` string: Scheduled start time
    - `dateEvent` string, date
    - `updated` string, date-time

---

[API](https://skmtc.dev/thesportsdb/apis/thesportsdb-v2-api.md) - [All operations](https://skmtc.dev/thesportsdb/apis/thesportsdb-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thesportsdb/apis/thesportsdb-v2-api/revisions/f529422e54bf?raw)
