Skip to main content
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>'
{
  "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
          }
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.nextsportsapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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