List teams

GET

/v1/teams

curl --request GET \
  --url 'https://api.ligr.live/rest/v1/teams?providerName=RB&limit=200&offset=0' \
  --header 'Authorization: Bearer <token>'

• LIGR REST API

Return a page of your organization’s teams, sorted by id. Filter by data provider to find the teams that a provider supplies.

Authorizations

• bearer
  teams:read
• api_key
  teams:read

Parameters

Query Parameters

providerName

string

Allowed values: RB OPTA_CRICKET OPTA_FOOTBALL OPTA_RUGBY_UNION STATSLLC GENIUS_BASKETBALL GENIUS_GRIDIRON GENIUS_VOLLEYBALL GENIUS_FOOTBALL GENIUS_ICE_HOCKEY PIXELLOT CLOUDMIX CHAMPION ligr-live-score MLB IMG_FOOTBALL CRIONET_TENNIS SPORT_RADAR_FOOTBALL

Only return teams from this data provider

providerIds

string

Only return teams with these ids at the data provider. A comma-separated list of up to 100 ids. Needs providerName.

limit

number format: double

default: 200

The maximum number of teams to return

offset

number format: double

0

The number of teams to skip

Responses

200

Ok

Media typeapplication/json

object

teams

required

Array<object>

object

id

required

Entity identifier

integer format: int32

>= 1

name

required

Default Entity name

string

>= 6 characters <= 39 characters

gfxName

Name predominantly display in graphics

string

>= 6 characters <= 19 characters

gfxFullName

Name predominantly display in graphics

string

>= 6 characters <= 35 characters

abbreviation

Abbreviation

string

>= 2 characters <= 4 characters

primaryBackgroundColor

string

primaryTextColor

string

secondaryBackgroundColor

string

secondaryTextColor

string

defaultVenueId

Entity identifier

integer format: int32

>= 1

sport

required

string

Allowed values: football rugbyUnion rugbyLeague netball cricket futsal iceHockey fieldHockey waterPolo handBall lacrosse touchFootball ausRules basketball rugbySevens gridiron volleyball baseball tennis

clubId

Entity identifier

integer format: int32

>= 1

isHome

boolean

logoUrl

CDN URL of the team logo, or of the club logo when the team has none. Present only on the team routes.

string

nonPlayerStaff

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.

Array<object>

A coach or other staff member of a team.

object

firstName

required

string

lastName

required

string

role

required

Role of a team staff member. Graphics show the manager as the coach.

string

Allowed values: manager assistantManager

dataProvider

object

name

required

string

Allowed values: RB OPTA_CRICKET OPTA_FOOTBALL OPTA_RUGBY_UNION STATSLLC GENIUS_BASKETBALL GENIUS_GRIDIRON GENIUS_VOLLEYBALL GENIUS_FOOTBALL GENIUS_ICE_HOCKEY PIXELLOT CLOUDMIX CHAMPION ligr-live-score MLB IMG_FOOTBALL CRIONET_TENNIS SPORT_RADAR_FOOTBALL

id

required

string

total

required

number format: double

returned

required

number format: double

Example

{
  "teams": [
    {
      "sport": "football",
      "nonPlayerStaff": [
        {
          "role": "manager"
        }
      ],
      "dataProvider": {
        "name": "RB"
      }
    }
  ]
}

400

Request is invalid

Media typeapplication/json

object

message

required

string

details

required

object

key

additional properties

Example^generated

{
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

401

Missing or invalid api key

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

403

Api key provides insufficient access for the request

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

404

Team not found

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

429

Api key has made too many requests

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

500

An unexpected error has occured. If problems persist please contact support

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}