Skip to main content
Every list response has the shape { "data": [...], "meta": {...} }. What meta contains depends on whether the list is bounded or a feed.

Bounded lists

Trackers, tags, segments, personas, analytics buckets, pages, contacts and opportunities return everything that matches up to the endpoint’s limit, with meta.returned:

Companies

/companies pages with limit (default 50, maximum 500) and offset (maximum 50,000). meta.has_more tells you whether another page exists; meta.total is filled only when you pass include_total=true, because counting roughly doubles the cost.
Python
The same meta shape applies to POST /companies and to /opportunities.

Feeds

Sessions, identified visitors, form submissions and Leadbot submissions are append-only feeds. They return meta.total (with include_total=true), meta.has_more and meta.returned, but no offset: rows are ordered by time, so narrow the date window instead of paging when has_more is true.
Python
Company-level questions are almost always cheaper through /companies than by aggregating raw sessions yourself: the row already carries sessions, pages, duration, first and last seen and the scores.