Pagination and incremental sync

Lists are cursor-paginated, not offset-paginated:

curl "https://sandbox-api.biklo.com/v1/products?limit=100" -H "Authorization: Bearer $KEY"

{ "count": 100, "next_cursor": "165987", "data": [ ��� ] }

Pass next_cursor back as ?cursor= until it comes back null.

Offset paging would silently miss products: rows shift while you walk a large catalog, and page 7 is not the same page 7 a minute later. A cursor is stable.

Sync incrementally, not fully#

Every list accepts updated_since. Store the timestamp of your last successful sync and pass it back:

curl "https://sandbox-api.biklo.com/v1/orders?updated_since=2026-09-09T00:00:00Z" \
  -H "Authorization: Bearer $KEY"

Timestamps are ISO 8601 in UTC, always Z-suffixed. Send them the same way.

Better still: stop polling#

If you are polling orders on a timer, register a webhook instead. You get the order within seconds instead of minutes, and you stop spending your rate limit on "nothing changed".