Get a team
GET/v1/teams/{teamId}
const url = 'https://api.ligr.live/rest/v1/teams/1?disableClubFallback=false';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.ligr.live/rest/v1/teams/1?disableClubFallback=false' \ --header 'Authorization: Bearer <token>'Return the team with the given ID.
Accepts the include query parameter with codes p, v, c, one level deep.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Entity identifier
The team id
Query Parameters
Section titled “Query Parameters”Comma seperated string of entity abbreviations Allows optional population of nested entities v = venue p = players c = competitions e.g. ‘c,p,v’
Responses
Section titled “Responses”Ok
object
Entity identifier
Default Entity name
Name predominantly display in graphics
Name predominantly display in graphics
Abbreviation
Entity identifier
Entity identifier
CDN URL of the team logo, or of the club logo when the team has none. Present only on the team routes.
Coaches and other staff who are not players. Graphics show the manager entry as the coach.
If no entry has the manager role, graphics show the first entry.
A coach or other staff member of a team.
object
Role of a team staff member. Graphics show the manager as the coach.
object
The kit colours of the team, per kit. A kit that the team does not set comes from its club.
A kit that neither sets is absent. Present only on GET, PATCH and the logo routes of
/v1/teams/{teamId}. A match picks one kit per team with homeTeamKitKey and awayTeamKitKey.
object
The two colours of one kit, as hex strings.
object
The two colours of one kit, as hex strings.
object
The two colours of one kit, as hex strings.
object
The two colours of one kit, as hex strings.
object
object
Entity identifier
Default Entity name
Name predominantly display in graphics
Name predominantly display in graphics
Abbreviation
Entity identifier
Entity identifier
CDN URL of the team logo, or of the club logo when the team has none. Present only on the team routes.
Coaches and other staff who are not players. Graphics show the manager entry as the coach.
If no entry has the manager role, graphics show the first entry.
A coach or other staff member of a team.
object
Role of a team staff member. Graphics show the manager as the coach.
object
The kit colours of the team, per kit. A kit that the team does not set comes from its club.
A kit that neither sets is absent. Present only on GET, PATCH and the logo routes of
/v1/teams/{teamId}. A match picks one kit per team with homeTeamKitKey and awayTeamKitKey.
object
The two colours of one kit, as hex strings.
object
The two colours of one kit, as hex strings.
object
The two colours of one kit, as hex strings.
object
The two colours of one kit, as hex strings.
object
object
Entity identifier
Default Entity name
Name predominantly display in graphics
object
object
Entity identifier
Default Player first name
Name predominantly display in graphics
Name predominantly display in graphics
Default Player first name
object
Entity identifier
Default Entity name
Name predominantly display in graphics
object
CDN URL of the competition logo. Present only on the competition routes.
CDN URL of the primary watermark. Present only on the competition routes.
CDN URL of the secondary watermark. Present only on the competition routes.
The match rules that every match of the competition inherits: the periods, the clock, the data
coverage and, for some sports, rules. The shape depends on the sport. A match config overrides
these values for one match. Change them with PATCH /v1/competitions/{competitionId}.
Example
{ "sport": "football", "nonPlayerStaff": [ { "role": "manager" } ], "dataProvider": { "name": "RB" }}Request is invalid
object
object
Examplegenerated
{ "message": "example", "details": { "additionalProperty": "example" }}Missing or invalid api key
object
Examplegenerated
{ "message": "example"}Api key provides insufficient access for the request
object
Examplegenerated
{ "message": "example"}Team not found
object
Examplegenerated
{ "message": "example"}Organization has made too many requests
object
Examplegenerated
{ "message": "example"}An unexpected error has occured. If problems persist please contact support
object
Examplegenerated
{ "message": "example"}