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

# Pagination

> Handle paginated responses from list endpoints.

## Overview

List endpoints that return multiple items may use pagination. agntdata uses cursor-based pagination for consistent, reliable paging through results.

## Request Parameters

Common pagination parameters:

| Parameter | Type    | Description                                 |
| --------- | ------- | ------------------------------------------- |
| `limit`   | integer | Number of items per page                    |
| `cursor`  | string  | Cursor from previous response for next page |

<Note>
  Not all endpoints support pagination. Check each endpoint's documentation for specific pagination details.
</Note>

## Response Structure

Responses include the data array and billing metadata:

```json theme={null}
{
  "success": true,
  "data": [
    { "id": "1", "title": "Item 1" },
    { "id": "2", "title": "Item 2" }
  ],
  "meta": {
    "costCents": 5,
    "purchasedBalanceCents": 944,
    "subscriptionRemainingCents": 500,
    "cached": false,
    "latencyMs": 312
  }
}
```

## Best Practices

<AccordionGroup>
  <Accordion title="Use Reasonable Page Sizes">
    Request only what you need. Larger pages mean fewer requests but longer response times.
  </Accordion>

  <Accordion title="Handle Cursors Correctly">
    Cursors are opaque strings — don't parse or modify them.
  </Accordion>

  <Accordion title="Implement Rate Limiting">
    When fetching many pages, add delays between requests to avoid rate limits.
  </Accordion>

  <Accordion title="Cache Results">
    Cache fetched data when appropriate to avoid re-fetching the same data.
  </Accordion>
</AccordionGroup>

## Credit Consumption

Each paginated request consumes credits independently. Plan your fetching strategy to optimize credit usage.

## Next Steps

<CardGroup cols={2}>
  <Card title="Request Format" icon="code" href="/data-apis/requests">
    Learn about request structure.
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/concepts/rate-limits">
    Understand rate limiting.
  </Card>
</CardGroup>