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

# Pagination

> Page through large result sets with two query parameters: page and limit.

List endpoints support pagination using `page` and `limit`.

## Parameters

* `page` — page index (starts at `0`)
* `limit` — number of results per page (default: `50`)

## Example

```bash theme={null}
curl --request GET \
  --url 'https://app.tryspecter.com/api/v1/searches/companies/5432/results?page=1&limit=500' \
  --header 'X-API-Key: YOUR_API_KEY'
```

## Limits

* Maximum `limit` is typically 5000
* Some endpoints use lower caps (e.g. name search: 10, people: 100, transactions: 1000)
* Exceeding the limit returns `400`

See each endpoint for its exact cap.

## When to stop

* If response headers include totals (`X-Total-Count`, `X-Total-Pages`), use them
* Where present, follow the RFC 5988 `Link` header (`next` / `prev` URLs) to walk pages
* Otherwise, stop when a page returns fewer than `limit` results