Basic Usage
Fetch all items from a database:Type Safety
NotCMS provides full type inference for list results:Filter and sort
list() without arguments still returns all pages.
At most 10 conditions can be combined, including multiple operators on a property. Empty means a missing property,
null, an empty string or an empty array. not_equals also matches empty values; use is_empty to match null explicitly.
Dates are compared in UTC. A date without a time is midnight UTC (09:00 in Japan), and a timestamp without a timezone is also UTC. A date range uses its start. Invalid dates are rejected.
sort accepts exactly one scalar property with "asc" or "desc". Array properties cannot be sorted. Empty values come last in either direction. Ties, and lists without sort, use registration order followed by page ID. Unknown properties, unsupported operators and invalid inputs return HTTP 400 through the usual error tuple.
Retrieve related pages by ID
A relation contains Notion page IDs. Retrieve the related pages from a database you select, with at most 100 IDs per call:id: { in: [...] } targets page IDs. A schema property named id still supports its regular conditions such as id: { equals: "custom-value" }.
For error tuples, HTTP 429, and retry guidance, see Errors and Rate Limits.
Next Steps
Get Single Item
Learn to fetch individual items
Client API
Explore the complete Client API