Skip to content

Pagination ​

List endpoints return one page at a time and use a cursor to fetch the next one.

Parameters ​

ParameterDefaultMaxDescription
limit100500Records per page. Values above 500 are treated as 500.
cursornoneThe meta.nextCursor value from the previous page.

Response shape ​

json
{
  "data": [ … ],
  "meta": {
    "limit": 100,
    "hasMore": true,
    "nextCursor": "eyJ2IjoxLCJpZCI6ImNtMXZlaDAwMDQifQ"
  }
}
  • hasMore is true when another page exists.
  • nextCursor is null on the last page.

Walking every page ​

bash
CURSOR=""
while : ; do
  PAGE=$(curl -s "$BASE/fleet/vehicles?limit=500${CURSOR:+&cursor=$CURSOR}" \
    -H "Authorization: Bearer $TOKEN")
  echo "$PAGE" | jq '.data[]'
  CURSOR=$(echo "$PAGE" | jq -r '.meta.nextCursor // empty')
  [ -z "$CURSOR" ] && break
done

Keep every other filter the same when you pass a cursor. A cursor is opaque: don't build or change one yourself.

Endpoints that are not paginated ​

These return everything in one response, with meta.count:

Partner API v1