Skip to main content
GET
Get leagues and cups

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

id
string

NextSportsAPI public identifier returned by this API.

Example:

"L7K9Q2R"

name
string

Exact or partial resource name.

country
string

Country name.

code
string

Country code.

season
integer

Four-digit season year.

Required range: 1900 <= x <= 2200
Example:

2026

team
string

NextSportsAPI team public identifier.

Example:

"T3MUN7A"

type
enum<string>

Competition type.

Available options:
league,
cup
current
boolean

Return only the current season or current round.

Search value. Use at least 3 characters where applicable.

Minimum string length: 3
last
integer

Return the last N records.

Required range: 1 <= x <= 99

Response

Successful response.

get
string
required
parameters
required
errors
object[]
required
results
integer
required
Required range: x >= 0
paging
object
required
response
object[]
required
Last modified on May 20, 2026