Skip to main content
Blend’s list endpoints return a flat JSON array, not a wrapped object. Pagination metadata lives in the response headers instead of the body, so you read X-Total-Count and friends rather than looking for a total key. Control the window with the page and page_size query parameters; page_size defaults to 25 and is capped at 200.

Read the headers

Loop until you’ve drained it

X-Remaining-Count is the cleanest stopping condition — keep requesting until it reaches 0.
Combine pagination with filters rather than paging through everything. GET /orders?status=picked,verified and GET /orders?has_unmatched_prescriptions=true will nearly always be faster than draining the full list and filtering client-side.
Requesting a page_size above 200 does not error — it is clamped to 200. Trust X-Page-Size in the response over the value you asked for.

Get orders

Paginated, filterable by status

Get patients

Paginated

Get prescriptions

Paginated, filterable