Skip to main content
GET
https://api.nextsportsapi.com
/
v1
/
football
/
fixtures
Get fixtures
curl --request GET \
  --url https://api.nextsportsapi.com/v1/football/fixtures \
  --header 'Authorization: Bearer <token>'
{
  "get": "football/fixtures",
  "parameters": {
    "date": "2026-08-16",
    "league": "L7K9Q2R",
    "season": "2026"
  },
  "errors": [],
  "results": 1,
  "paging": {
    "current": 1,
    "total": 1
  },
  "response": [
    {
      "fixture": {
        "id": "MBH7KQ2",
        "date": "2026-08-16T15:00:00+00:00",
        "timezone": "UTC",
        "status": {
          "long": "Not Started",
          "short": "NS",
          "elapsed": null
        }
      },
      "league": {
        "id": "L7K9Q2R",
        "name": "Premier League",
        "season": 2026,
        "round": "Regular Season - 1"
      },
      "teams": {
        "home": {
          "id": "T3MUN7A",
          "name": "Manchester United"
        },
        "away": {
          "id": "T8LIV4B",
          "name": "Liverpool"
        }
      },
      "goals": {
        "home": null,
        "away": null
      },
      "score": {
        "halftime": {
          "home": null,
          "away": null
        },
        "fulltime": {
          "home": null,
          "away": null
        }
      }
    }
  ]
}

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"

ids
string

Comma-separated list of NextSportsAPI public identifiers.

Example:

"MBH7KQ2,MBH8J3A"

live
string

Use all or one or more league IDs for live fixtures.

Example:

"all"

date
string<date>

Single date filter in YYYY-MM-DD format.

Example:

"2026-08-16"

league
string

NextSportsAPI league public identifier.

Example:

"L7K9Q2R"

season
integer

Four-digit season year.

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

2026

team
string

NextSportsAPI team public identifier.

Example:

"T3MUN7A"

last
integer

Return the last N records.

Required range: 1 <= x <= 99
next
integer

Return the next N fixtures.

Required range: 1 <= x <= 99
from
string<date>

Start date in YYYY-MM-DD format.

to
string<date>

End date in YYYY-MM-DD format.

round
string

Competition round name.

status
string

Fixture status code or comma-separated status codes.

Example:

"NS,1H,HT,2H,FT"

venue
string

NextSportsAPI venue public identifier.

Example:

"V5H8J2K"

timezone
string

Timezone name from the timezone endpoint.

Example:

"Asia/Tokyo"

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