Skip to main content
List endpoints use cursor-based pagination. Each response contains a pagination object with the cursors needed to fetch the next or previous page.

​
Response shape

{
  "data": [
    { "id": "loc_01HW8K9ZQ7", "...": "..." }
  ],
  "pagination": {
    "next_cursor": "eyJpZCI6ImxvY18wMUhXOEs5WlE3In0",
    "previous_cursor": null,
    "has_more": true
  }
}

​
Fetching the next page

Pass the next_cursor value back as the cursor query parameter: 
curl "https://api.spirii.com/v1/locations?cursor=eyJpZCI6ImxvY18wMUhXOEs5WlE3In0&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
Default page size is 25. Maximum is 100. Choose a size that matches your downstream batch processing.