Pagination

List endpoints accept limit (1–100, default 25) and offset (default 0). Responses include items and total.

curl -s 'https://api.circa.ai/public/materials?limit=50&offset=100' \
  -H 'x-api-key: circa_live_xxx'

200OK

{
  "items": [ /* up to 50 records */ ],
  "total": 12453,
  "hasMore": true
}

Every list endpoint (/materials, /processes, ?pulled=true variants, GraphQL materials / processes) returns the same shape:

items — the page of records, capped at the requested limit.
total — total matching records when the underlying service knows the count. For some sources (e.g. the process aggregator) total falls back to items.length — use hasMore to decide whether to paginate.
hasMore — true if there is at least one more record past offset + items.length.

For large collections, iterate with stable offset values and cap parallelism to stay under the rate limit.