Choose the page size of any list with per_page

Every list endpoint now takes per_page, from 1 up to 100 records per response, with 20 still the default. The cursor contract is unchanged: follow Pagination-Next or the Link header exactly as before, and the next-page URL carries the size you asked for.

A full sync of a large workspace used to cost one request per 20 records, so 150,000 orders meant seven and a half thousand calls. At 100 per page that is five times fewer round trips. After your initial sync, use webhooks to keep your records up to date. Repeat full syncs only as an exception. A larger value returns 100 records. Zero, a negative, or a value that is not a whole number is a 422 rather than a silent fall-back, so a sync finds out on its first call.

Agent examples: pull a workspace's orders into a warehouse at 100 a call · back up every contact before a bulk tag change

Resources: Pagination guide · List Contacts · List Orders. Building with an AI agent? Point it at the Contacts skill.