> ## 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.

# Response Format

> Understand the standard response envelope, pagination fields, and endpoint payloads.

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

```json theme={"system"}
{
  "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`.

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