Pagination

List endpoints are paginated with an opaque cursor.

limitRecords per page. Default 25, maximum 100.
cursorPass the cursor from the previous response to fetch the next page.

Every list response tells you where you are:

{
  "success": true,
  "error": "",
  "count": 1,
  "remaining": 17,
  "cursor": "bzox",
  "data": [ ... ]
}
  • count is the number of records in this page.
  • remaining is how many are left after it.
  • cursor is what to send next. It is an empty string when there are no
    more pages
    — that, rather than remaining, is the condition to loop on.
# first page
curl "https://api.djfindr.com/prod/v1/public/djs?limit=25" \
  -H "Authorization: Bearer djf_sk_..."

# next page
curl "https://api.djfindr.com/prod/v1/public/djs?limit=25&cursor=bzox" \
  -H "Authorization: Bearer djf_sk_..."

Treat the cursor as opaque. It encodes a position and its format may change; do
not construct one yourself or store it as a bookmark for later.

Filters must be repeated on every request in a run. A cursor records a position
within a result set, not the query that produced it, so changing the filters
mid-run gives you a page from a different set at the same offset.