Skip to main content
A content type’s list answers one page of documents, and where you are in the list.
object[]
This page’s documents.
integer
How many pages the list has.
integer
The page this is, from 1.

Asking for a page

integer
default:"1"
The page to answer, from 1.
integer
Documents per page. Each content type has its own default. There is no upper limit, but a large page of a big list is slow: page through it instead.
A few lists page their own way, and say so in the API reference: the media lists (limit, total), conversion events (a since cursor) and the request log.

Walking a whole list

Each list method has an …All() twin in the SDKs: it fetches a page at a time as you go and stops after the last, however the list pages. No paging by hand.
Only after ids? Each list method also has a …Pick() twin that walks every page for just the fields you name: Find an id.

Searching and filtering

search

Matches documents by their text.

slug

Finds one document by its URL name.
Every other filter a list takes is on its page in the API reference.