Pagination - Notealy

List endpoints (GET /v1/people, GET /v1/companies, …) return a cursor-paginated envelope:

{
  "data": [ /* up to `limit` records */ ],
  "nextCursor": "01JABCDEF..."
}

When nextCursor is null, you have reached the end. Otherwise, pass it back as the cursor query parameter to fetch the next page:

curl "https://thanos.notealy.com/v1/people?limit=100&cursor=01JABCDEF..." \
  -H "Authorization: Bearer sk_live_..."

Parameters

Parameter	Default	Notes
`limit`	`50`	Max page size — see the API reference for the per-resource cap
`cursor`	(none)	Opaque value from the previous response’s `nextCursor`

Records are ordered by creation time, newest first. The cursor encodes the last id of the previous page; do not parse or generate it yourself.

Idempotency note

Cursor pagination is stable as long as the underlying records are not deleted between page fetches. If a record at the cursor boundary is deleted, the next page request will fall back to the next valid record — you may miss the deleted one but never see duplicates.