The monday.com items_page API enables you to read items on a board using expressive filters.

Each of the object types described below represents a specific aspect of a filter. They can be provided as arguments to define a filtered items query.

ItemsQuery

An object containing a set of parameters to filter, sort, and control the scope of the query.

Field	Description	Enum Values	Supported Fields
groups `[ItemsQueryGroup!]`	The group rules and attributes to filter your queries.		groups `[ItemsQueryGroup!]` operator `ItemsQueryOperator` rules `[ItemsQueryRule!]`
ids `[ID!]`	The specific item IDs to return. The maximum is 100.
operator `ItemsQueryOperator`	The conditions between query rules. The default is `and`.	`and` `or`
order_by `[ItemsQueryOrderBy!]`	The attributes to sort results by.		column_id `String!` direction `ItemsOrderByDirection`
rules `[ItemsQueryRule!]`	The rules to filter your queries.		column_id `ID!` compare_attribute `String` compare_value `CompareValue!` operator `ItemsQueryRuleOperator`

ItemsQueryGroup

An object containing the group rules.

Field	Description	Enum Values	Supported Fields
groups `[ItemsQueryGroup!]`	The group rules and attributes to filter your queries.		groups `[ItemsQueryGroup!]` operator `ItemsQueryOperator` rules `[ItemsQueryRule!]`
operator `ItemsQueryOperator`	The conditions between query rules. The default is `and`.	`and` `or`
rules `[ItemsQueryRule!]`	The rules to filter your queries.		column_id `ID!` compare_attribute `String` compare_value `CompareValue!` operator `ItemsQueryRuleOperator`

ItemsQueryOrderBy

An object containing the attributes to sort results by.

Field	Description	Enum Values
column_id `String!`	The unique identifier of the column to filter or sort by. You can also enter `"__creation_log__"` or `"__last_updated__"` to chronologically sort results by their last updated or creation date (oldest to newest).
direction `ItemsOrderByDirection`	The direction to sort items in. The default is asc.	`asc` `desc`

ItemsQueryRule

An object containing the rules to filter your queries.

Field	Description	Enum Values
column_id `ID!`	The unique identifier of the column to filter by.
compare_attribute `String`	The comparison attribute. You can find the supported attributes for each column type in the column types reference. Most columns don't have a `compare_attribute`.
compare_value `CompareValue!`	The column value to filter by. This can be a `string` or index value depending on the column type. You can find the supported values for each column type in the column types reference.
operator `ItemsQueryRuleOperator`	The condition for value comparison. The default is `any_of`.	`any_of` `not_any_of` `is_empty` `is_not_empty` `greater_than` `greater_than_or_equals` `lower_than` `lower_than_or_equal` `between` `not_contains_text` `contains_text` `contains_terms` `starts_with` `ends_with` `within_the_next` `within_the_last`

Types for the root items_page query

🚧
Only available in API versions 2027-01 and later

The types below describe the input and the result of the root items_page query. Descriptions come from the live schema.

ItemsPageInput

Available in API versions 2027-01 and later.

Input arguments for the items_page query.

Field	Type	Description
`board_id`	`ID`	The board to query. Provide either `board_id` or `data_view_id`, not both.
`data_view_id`	`ID`	The data view UUID to query. Provide either `data_view_id` or `board_id`, not both.
`query`	`ItemsQuery`	Optional filter and sort configuration.
`limit`	`Int`	Page size (default 25, max 2000). This cap applies to the root `items_page` query. The nested `items_page` under `boards` has a maximum of 500.
`group_id`	`String`	Optional group ID to scope the query to a specific group.
`hierarchy_scope_config`	`String`	For multi-level boards: controls how filters apply across the item hierarchy. Use `allItems` to evaluate filters against parents and subitems and return matches at every level. Accepted values: `allItems`, `parentItems`.

ItemsPageResult

Available in API versions 2027-01 and later.

Paginated result set returned by the items_page query.

Field	Type	Description
`cursor`	`String`	Opaque pagination token, null if no more pages.
`items`	`[ItemResult!]`	The items in this page of results.
`linked_items`	`[ItemResult!]`	Linked items (relations, dependencies, subitems from other boards).

ItemResult

Available in API versions 2027-01 and later.

A single item returned by the items_page query.

Field	Type	Description
`id`	`ID`	The unique identifier of the item.
`name`	`String`	The name of the item.
`state`	`String`	The state of the item (active, deleted, etc.).
`group`	`ItemsPageGroup`	The group this item belongs to (id, title, color).
`board_id`	`ID`	The ID of the board this item belongs to. Populated only for data-view queries.
`created_at`	`String`	ISO 8601 timestamp of when the item was created.
`updated_at`	`String`	ISO 8601 timestamp of when the item was last updated.
`creator_id`	`ID`	The user ID of the item creator.
`creator`	`User`	The item's creator.
`column_values`	`[ItemsPageColumnValue!]`	Structured column values. Arguments: `ids` (`[ID!]`), `types` (`[ItemsPageColumnTypeFilter!]`), `capabilities` (`[ItemsPageColumnCapability!]`).
`subitems`	`[ItemResult!]`	Subitems of this item.
`parent_item`	`ItemResult`	The parent item when this item is a subitem within the result set. Null for top-level items.

ItemsPageGroup

The group an item belongs to.

Field	Type	Description
`id`	`ID`	The group ID.
`title`	`String`	The group title.
`color`	`String`	The group color.

ItemsPageColumnValue

Available in API versions 2027-01 and later.

A column value for an item returned by items_page.

Field	Type	Description
`id`	`ID`	Column ID. On the data view path this is the target column id.
`source_column_id`	`ID`	Data views only: the id this column has on the source board the item came from. Null for board queries, and for items whose board the view does not map this column on.
`target_column_id`	`ID`	Data views only: the column's id on the view's target schema. Null for board queries.
`type`	`String`	Column type.
`text`	`String`	Stringified text representation.
`value`	`String`	JSON string value matching old API format.
`is_leaf`	`Boolean!`	Multi-level boards: whether this item is a leaf (has no subitems).
`capabilities`	`ItemsPageColumnCapabilities!`	Column capabilities (calculated/rollup metadata on multi-level boards).
`column`	`ItemsPageColumn!`	Board-level metadata of this value's column (id, title, type, capabilities, settings). Not recommended: resolving column metadata per value is redundant across items — prefer querying it once per board via `boards { columns { ... } }` and joining client-side.

Implemented by: ItemsPageBatteryValue, ItemsPageBoardRelationValue, ItemsPageBoardValue, ItemsPageButtonValue, ItemsPageCheckboxValue, ItemsPageColorPickerValue, ItemsPageCountryValue, ItemsPageCreationLogValue, ItemsPageDateValue, ItemsPageDependencyValue, ItemsPageDirectDocValue, ItemsPageDocValue, ItemsPageDropdownValue, ItemsPageEmailValue, ItemsPageFileValue, ItemsPageFormulaValue, ItemsPageGroupValue, ItemsPageHourValue, ItemsPageItemIdValue, ItemsPageLastUpdatedValue, ItemsPageLinkValue, ItemsPageLocationValue, ItemsPageLongTextValue, ItemsPageMirrorValue, ItemsPageNumbersValue, ItemsPagePeopleValue, ItemsPagePhoneValue, ItemsPageProgressValue, ItemsPageRatingValue, ItemsPageStatusValue, ItemsPageSubtasksValue, ItemsPageTagsValue, ItemsPageTextValue, ItemsPageTimeTrackingValue, ItemsPageTimelineValue, ItemsPageUnknownValue, ItemsPageVoteValue, ItemsPageWeekValue, ItemsPageWorldClockValue.

ItemsPageBatteryValue

The rollup value of a status column on a multi-level board: a distribution of status counts.