Pagination

A list that can grow returns one page at a time:

{
  "data": {
    "items": [],
    "next_cursor": "eyJpZCI6IjAxSjhRWjRN..."
  }
}

Send next_cursor back as the after query parameter to get the next page, and stop when it is null:

curl "https://app.stockshift.io/api/v1/catalog/items?after=eyJpZCI6IjAxSjhRWjRN..." \
  -H "Authorization: Bearer $STOCKSHIFT_TOKEN"

Treat the cursor as opaque. Don’t parse it or build one yourself.

With an SDK

Every SDK follows the cursors for you:

for await (const item of stockshift.paginate("/catalog/items", { query: { search: "bolt" } })) {
  console.log(item.sku);
}

for item in stockshift.catalog.iter_items(search="bolt"):
    print(item.sku)

for item, err := range client.Catalog.ListItemsAll(ctx, nil) {
	if err != nil {
		return err
	}
	fmt.Println(item.SKU)
}

Each SDK’s page has the details.