Skip to content
Avaloi

API pagination

Page through list endpoints with limit and cursor, and stop when next_cursor is null.

List endpoints use cursor pagination. Pass limit (1 to 200, default 50) and an optional cursor.

Request a page

curl -s "https://api.avaloi.com/v1/companies/me/members?limit=50" \
  -H "Authorization: Bearer hk_live_YOUR_SECRET"

{
  "data": [],
  "next_cursor": "01J9K2Q7M4Z8X0T6Y3B5N1C2D4"
}

Follow the cursor

  1. Read data from the first page.
  2. When next_cursor is not null, request the same URL with ?cursor= set to that value.
  3. Stop when next_cursor is null.

Cursors are opaque. Do not build your own offsets or parse the cursor.

Limits

  • limit from 1 to 200.
  • Default page size 50.

Quick answers

Can I ask for page 3 directly? No. Follow next_cursor from one page to the next.

Can I store a cursor and resume later? Treat it as an opaque string and pass it back as you received it.

Which endpoints paginate? Every list endpoint, such as GET /v1/sites, GET /v1/companies/me/members, and GET /v1/jobs.

API

  • GET /v1/companies/me/members
  • GET /v1/sites
  • GET /v1/jobs

Still stuck?

Email [email protected] with your site name and what you tried, or send us a message.