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

# Pagination

> How pagination works in the Autheo Chain REST API.

The Autheo REST API returns paginated results for endpoints that can return large collections of data. All paginated responses follow a consistent format.

## Response format

Paginated endpoints return a JSON object with an `items` array and a `next_page_params` object:

```json theme={null}
{
  "items": [
    { "...": "..." }
  ],
  "next_page_params": {
    "block_number": 12345,
    "index": 10,
    "items_count": 50
  }
}
```

When `next_page_params` is `null`, you have reached the last page.

## Fetching the next page

Pass `next_page_params` as query parameters to retrieve the next page:

```bash theme={null}
# Initial request
curl "https://evm-explorer.autheo.com/api/v2/addresses/0x<address>/transactions"

# Next page — pass the params from next_page_params
curl "https://evm-explorer.autheo.com/api/v2/addresses/0x<address>/transactions?block_number=12345&index=10&items_count=50"
```

## JavaScript pagination helper

```javascript theme={null}
async function fetchAllPages(url) {
  const allItems = [];
  let nextParams = null;

  do {
    const queryString = nextParams
      ? "?" + new URLSearchParams(nextParams).toString()
      : "";

    const response = await fetch(url + queryString);
    const data = await response.json();

    allItems.push(...data.items);
    nextParams = data.next_page_params;
  } while (nextParams !== null);

  return allItems;
}

const transactions = await fetchAllPages(
  "https://evm-explorer.autheo.com/api/v2/addresses/0x<address>/transactions"
);
console.log("Total transactions:", transactions.length);
```

## Page size

The default page size is **50 items**. This is fixed per endpoint and cannot be changed via query parameters.

## Rate limiting

Paginating through large datasets with many sequential requests can trigger rate limits. Add a small delay between pages for large backfills:

```javascript theme={null}
await new Promise(r => setTimeout(r, 100)); // 100ms between pages
```