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.
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.