V2 API Lookup

Lookup sports league by ID

Lookup for any league using its unique ID.

get/lookup/league/{idLeague}

Request

Base URL
https://www.thesportsdb.com/api/v2/json
Auth
API key in header X-API-KEY
TypeScript
https://skmtc.dev/thesportsdb/apis/thesportsdb-v2-api/docs/lookup/league/:idLeague/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idLeagueinteger required

The ID of the league to lookup.

Response

League details for the given ID

Example response

{
  "lookup": [
    {
      "idLeague": "4328",
      "idAPIfootball": "7293",
      "strSport": "Soccer",
      "strLeague": "English Premier League",
      "strLeagueAlternate": "Premier League, EPL",
      "intDivision": "0",
      "idCup": "0",
      "strCurrentSeason": "2025-2026",
      "intFormedYear": "1992",
      "dateFirstEvent": "1992-08-15",
      "strGender": "Male",
      "strCountry": "England",
      "strWebsite": "https://www.premierleague.com",
      "strTvRights": "UK - Sky Sports [2022-2025]",
      "strBadge": "https://www.thesportsdb.com/images/media/league/badge/gasy9d1737743125.png",
      "strNaming": "{strHomeTeam} vs {strAwayTeam}"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.