Collections return a result.entityList + result.pageInformation envelope.
| Name | Default | Max |
|---|---|---|
page | 1 | — |
pageSize | 50 | 100 |
{
"result": {
"entityList": [/* ... */],
"pageInformation": {
"page": 1,
"pageSize": 50,
"totalPages": 12,
"totalItems": 574
}
}
}- Use
pageSize: 100for sync jobs — fewer calls, same cost. - Never rely on
totalItemsto detect the last page: iterate whilepage < totalPages. - Back off if you see
429; the rate limit is per IP, not per page.
let page = 1;
while (true) {
const { result } = await fetchPage(page);
await process(result.entityList);
if (page >= result.pageInformation.totalPages) break;
page += 1;
}