> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://usehelloai.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://usehelloai.ferndocs.com/_mcp/server.

# Pagination

List endpoints (`GET /receipts`, `GET /audit/log`, `GET /billing/trusted-events`) return paginated results. The SDKs expose auto-paginating iterators so you don't need to manage page tokens manually.

## Python — iterate all results

```python
# Iterates all pages automatically
for receipt in client.receipts.list():
    print(receipt.receipt_id)
```

## Python — page-by-page

```python
pager = client.receipts.list(per_page=50)
for page in pager.iter_pages():
    print(f"Page has {len(list(page))} receipts")
```

## TypeScript — async iterator

```typescript
const pager = await client.receipts.list({ per_page: 50 });
for await (const receipt of pager) {
  console.log(receipt.receipt_id);
}
```

## TypeScript — page-by-page

```typescript
const pager = await client.receipts.list();
for await (const page of pager.iterPages()) {
  console.log(page.items);
}
```

## Filtering

All list endpoints accept `page` and `per_page` query parameters. `GET /receipts` also supports filtering by `compliance_verdict`, date ranges, `agent_id`, and `tenant_id` — see the API Reference for the full parameter list.