Appearance
Pagination
List endpoints return one page at a time and use a cursor to fetch the next one.
Parameters
| Parameter | Default | Max | Description |
|---|---|---|---|
limit | 100 | 500 | Records per page. Values above 500 are treated as 500. |
cursor | none | The meta.nextCursor value from the previous page. |
Response shape
json
{
"data": [ … ],
"meta": {
"limit": 100,
"hasMore": true,
"nextCursor": "eyJ2IjoxLCJpZCI6ImNtMXZlaDAwMDQifQ"
}
}hasMoreistruewhen another page exists.nextCursorisnullon 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
doneKeep 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:
GET /fleet/positions: the whole fleet's live positions.GET /fleet/trips: one vehicle over at most 7 days, up to 1,000 trips (meta.truncatedistrueif there were more).GET /fleet/driving-times: at most 31 days.GET /vehicles: the v1 fleet snapshot.