> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nt3.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> Navigate large result sets with page-based pagination.

Endpoints that return collections use **offset-based pagination** with `page` and `limit` query parameters.

## Query Parameters

| Parameter | Type   | Default | Description                                                       |
| --------- | ------ | ------- | ----------------------------------------------------------------- |
| `page`    | number | `1`     | The page number to retrieve. Starts at 1.                         |
| `limit`   | number | `50`    | Maximum number of records to return per page. Maximum value: 200. |

## Response Shape

Every paginated endpoint wraps results in a consistent envelope:

```json theme={null}
{
  "data": [...],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 243,
    "totalPages": 5
  }
}
```

<ResponseField name="data" type="array">
  The array of result objects for this page.
</ResponseField>

<ResponseField name="meta.page" type="number">
  The current page number.
</ResponseField>

<ResponseField name="meta.limit" type="number">
  The page size used for this request.
</ResponseField>

<ResponseField name="meta.total" type="number">
  The total number of records across all pages.
</ResponseField>

<ResponseField name="meta.totalPages" type="number">
  The total number of pages given the current `limit`.
</ResponseField>

## Example Request

```bash theme={null}
curl "https://app.nt3.io/api/projects/proj_abc123/keys?page=2&limit=50" \
  -H "X-API-Key: entri_your_token_here"
```

```json theme={null}
{
  "data": [
    { "id": "key_051", "key": "nav.home", "description": "Navigation home label" },
    { "id": "key_052", "key": "nav.about", "description": "Navigation about label" }
  ],
  "meta": {
    "page": 2,
    "limit": 50,
    "total": 243,
    "totalPages": 5
  }
}
```

## Fetching All Pages

To retrieve the complete result set, iterate until `page >= meta.totalPages`:

<Tabs>
  <Tab title="JavaScript">
    ```javascript theme={null}
    async function fetchAllKeys(projectId) {
      const keys = [];
      let page = 1;
      let totalPages = 1;

      do {
        const response = await fetch(
          `https://app.nt3.io/api/projects/${projectId}/keys?page=${page}&limit=100`,
          { headers: { "X-API-Key": process.env.ENTRI_API_KEY } }
        );

        const result = await response.json();
        keys.push(...result.data);
        totalPages = result.meta.totalPages;
        page++;
      } while (page <= totalPages);

      return keys;
    }
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import httpx

    def fetch_all_keys(project_id: str) -> list:
        keys = []
        page = 1
        headers = {"X-API-Key": "entri_your_token_here"}

        with httpx.Client(base_url="https://app.nt3.io/api") as client:
            while True:
                response = client.get(
                    f"/projects/{project_id}/keys",
                    params={"page": page, "limit": 100},
                    headers=headers,
                )
                result = response.json()
                keys.extend(result["data"])

                if page >= result["meta"]["totalPages"]:
                    break
                page += 1

        return keys
    ```
  </Tab>
</Tabs>

## Notes

* Page numbers start at `1`. Requesting page `0` is equivalent to page `1`.
* The `limit` parameter caps the maximum records per page. The server may return fewer records than requested on the last page.
* Endpoints that do not return large collections (such as fetching a single project by ID) do not support pagination parameters.