Get leagues and cups
curl --request GET \
--url https://api.nextsportsapi.com/v1/football/leagues \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.nextsportsapi.com/v1/football/leagues"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nextsportsapi.com/v1/football/leagues', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"get": "football/leagues",
"parameters": {
"id": "L7K9Q2R",
"season": "2026"
},
"errors": [],
"results": 1,
"paging": {
"current": 1,
"total": 1
},
"response": [
{
"league": {
"id": "L7K9Q2R",
"name": "Premier League",
"type": "league",
"logo": "https://media.nextsportsapi.com/football/leagues/39.png"
},
"country": {
"name": "England",
"code": "GB-ENG",
"flag": "https://media.nextsportsapi.com/flags/gb-eng.svg"
},
"seasons": [
{
"year": 2026,
"current": true,
"coverage": {
"fixtures": {
"events": true,
"lineups": true
},
"standings": true,
"players": true
}
}
]
}
]
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}Get leagues and cups
Returns available leagues and cups, including country, seasons, and coverage metadata.
GET
https://api.nextsportsapi.com
/
v1
/
football
/
leagues
Get leagues and cups
curl --request GET \
--url https://api.nextsportsapi.com/v1/football/leagues \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.nextsportsapi.com/v1/football/leagues"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nextsportsapi.com/v1/football/leagues', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"get": "football/leagues",
"parameters": {
"id": "L7K9Q2R",
"season": "2026"
},
"errors": [],
"results": 1,
"paging": {
"current": 1,
"total": 1
},
"response": [
{
"league": {
"id": "L7K9Q2R",
"name": "Premier League",
"type": "league",
"logo": "https://media.nextsportsapi.com/football/leagues/39.png"
},
"country": {
"name": "England",
"code": "GB-ENG",
"flag": "https://media.nextsportsapi.com/flags/gb-eng.svg"
},
"seasons": [
{
"year": 2026,
"current": true,
"coverage": {
"fixtures": {
"events": true,
"lineups": true
},
"standings": true,
"players": true
}
}
]
}
]
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}{
"get": "football/standings",
"parameters": {},
"errors": [
{
"code": "validation.required_parameter",
"message": "The season parameter is required.",
"param": "season"
}
],
"results": 0,
"paging": {
"current": 1,
"total": 1
},
"response": []
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
NextSportsAPI public identifier returned by this API.
Example:
"L7K9Q2R"
Exact or partial resource name.
Country name.
Country code.
Four-digit season year.
Required range:
1900 <= x <= 2200Example:
2026
NextSportsAPI team public identifier.
Example:
"T3MUN7A"
Competition type.
Available options:
league, cup Return only the current season or current round.
Search value. Use at least 3 characters where applicable.
Minimum string length:
3Return the last N records.
Required range:
1 <= x <= 99Last modified on May 20, 2026