# Pagination

Append-heavy lists use one convention.

| Parameter | Meaning |
|---|---|
| `limit` | how many, 1 to 200. The default is 50. |
| `cursor` | where to carry on, from an earlier `next_cursor` |

Results are newest first.

```sh
curl "https://api.heyclave.party/v1/forms/<form id>/submissions?limit=100" \
  -H "Authorization: Bearer $CLAVE_API_TOKEN"
```

## When to stop

`next_cursor` is absent on the last page. That absence is the signal.

A cursor Clave did not mint is a 400 with `invalid_cursor`. Do not build
one; pass back the one you were given.

## What is paginated

Submissions, deployments and the audit log the operator reads.

## What is not

Sites, domains, forms and tokens are not paginated, and that is on
purpose. Each is bounded by a cap the account can read, so a page of them
is the whole list.

---

## Where this page sits

This is one page of the Clave documentation.
Read it as a web page at https://docs.heyclave.party/api/pagination.
Every page has a `.md` address, and https://docs.heyclave.party/llms.txt lists them all.

- Previous: [Errors](https://docs.heyclave.party/api/errors.md)
- Next: [The publish contract](https://docs.heyclave.party/api/publish.md)
- Index: [Overview](https://docs.heyclave.party/index.md)