Response Format

Most endpoints return a common JSON envelope. The response field contains the endpoint-specific data.

{
  "get": "football/fixtures",
  "parameters": {
    "date": "2026-08-16",
    "league": "L7K9Q2R",
    "season": "2026"
  },
  "errors": [],
  "results": 10,
  "paging": {
    "current": 1,
    "total": 1
  },
  "response": []
}

Envelope fields

Field	Type	Description
`get`	string	Endpoint name returned for traceability.
`parameters`	object	Query parameters accepted by the request. Values are returned as strings when they come from the URL query.
`errors`	array	Empty array for successful requests. Contains one or more error objects when the request fails.
`results`	integer	Number of records returned in `response`.
`paging.current`	integer	Current response page.
`paging.total`	integer	Total pages available for the request.
`response`	array or object	Endpoint-specific payload.

Empty data

When a valid request has no matching records, the API may return 200 with results: 0 and an empty response array, or 204 No Content for endpoints where no body is returned.

Pagination

Endpoints that can return many records support page. When paging.total is greater than paging.current, request the next page with page=paging.current + 1.

curl --request GET \
  "https://api.nextsportsapi.com/v1/football/players?league=L7K9Q2R&season=2026&page=2" \
  --header "Authorization: Bearer YOUR_API_KEY"

Get Started

Guides

API Reference

Release Notes

Envelope fields

Empty data

​Envelope fields

​Empty data

​Pagination

Envelope fields

Empty data

Pagination