Skip to main content
GET
/
leagues
Leagues
curl --request GET \
  --url 'https://api.eliteprospects.com/v1/leagues?apiKey='
{
  "_meta": {
    "generatedAt": "<string>",
    "offset": 123,
    "limit": 123,
    "totalRecords": 123
  },
  "_links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  },
  "data": [
    {
      "slug": "<string>",
      "name": "<string>",
      "fullName": "<string>",
      "commonName": "<string>",
      "leagueType": "<string>",
      "leagueLevel": "<string>",
      "defaultSeason": {
        "slug": "<string>",
        "startYear": 123,
        "endYear": 123
      },
      "activeSeason": {
        "slug": "<string>",
        "startYear": 123,
        "endYear": 123
      },
      "country": {
        "slug": "<string>",
        "name": "<string>",
        "iso_3166_1_alpha_2": "<string>",
        "flagUrl": {
          "small": "<string>",
          "medium": "<string>"
        },
        "eliteprospectsUrlPath": "<string>",
        "updatedAt": "<string>",
        "_links": [
          "<string>"
        ]
      },
      "region": "<string>",
      "flagUrl": {
        "small": "<string>",
        "medium": "<string>"
      },
      "logo": {
        "url": "<string>",
        "colors": [
          "<string>"
        ],
        "hasTransparency": true
      },
      "logoUrl": "<string>",
      "imageUrl": "<string>",
      "numberOfTeams": 123,
      "primaryDraftType": {
        "slug": "<string>",
        "name": "<string>",
        "league": "<unknown>",
        "_links": [
          "<string>"
        ],
        "eliteprospectsUrlPath": "<string>"
      },
      "existsInLeagueEndpoint": true,
      "hasProjectedStats": true,
      "historicalData": [
        {
          "slug": "<string>",
          "name": "<string>",
          "fullName": "<string>",
          "firstSeason": {
            "slug": "<string>",
            "startYear": 123,
            "endYear": 123
          },
          "lastSeason": {
            "slug": "<string>",
            "startYear": 123,
            "endYear": 123
          }
        }
      ],
      "links": {
        "eliteprospectsUrl": "<string>",
        "officialWebUrl": "<string>",
        "statsUrl": "<string>",
        "newsUrls": [
          "<string>"
        ],
        "forumUrl": "<string>",
        "facebook": "<string>",
        "x": "<string>",
        "twitter": "<string>",
        "instagram": "<string>",
        "youtube": "<string>"
      },
      "eliteprospectsUrlPath": "<string>",
      "updatedAt": "<string>",
      "_links": [
        "<string>"
      ]
    }
  ]
}

Authorizations

apiKey
string
query
required

Query Parameters

fields
enum<string>[]

Specify custom response with available response fields.


Fields included as default: id, slug, name, fullName, commonName, teamClass, leagueType, leagueLevel, scheduleType, country, continent, region, flagUrl, logo, logoUrl, imageUrl, numberOfTeams, primaryDraftType, existsInLeagueEndpoint, links, eliteprospectsUrlPath, updatedAt, _links

Available options:
id,
slug,
name,
fullName,
commonName,
teamClass,
leagueType,
leagueLevel,
scheduleType,
country,
continent,
region,
flagUrl,
logo,
logoUrl,
imageUrl,
numberOfTeams,
primaryDraftType,
existsInLeagueEndpoint,
links,
eliteprospectsUrlPath,
updatedAt,
_links,
country.*,
flagUrl.*,
logo.*,
primaryDraftType.*,
links.*,
*
offset
integer
default:0

The number of items to skip before starting to collect the result set.

Required range: x >= 0
limit
integer
default:100

The number of items to return.

Required range: 0 <= x <= 1000
sort
enum<string>[]

Sort results by field name. Prefix with - for descending order (e.g., -name).

Available options:
name,
-name,
country,
-country,
updatedAt,
-updatedAt
q
string

Full-text search by name

slug
string[]

Filter by slug

name
string

Filter by name

country
string

Filter by country slug in ISO 3166-1 alpha-3

teamClass
enum<string>

Filter by teamClass

Available options:
men,
women
leagueType
string

Filter by leagueType

leagueLevel
string

Filter by leagueLevel

updatedAt:min
string<date-time>

Filter by updatedAt greater or equal to in ISO-8601 format for date and time

Response

200 - application/json

A paginated list of leagues.

_meta
object
data
object[]