The monday.com search API lets you search for items, boards, and documents in a single query. This page documents the input types, result types, and enum types used by the search query.

SearchResult

A union type representing the different entity types that can be returned from a search query.

Possible types:

ItemSearchResult
BoardSearchResult
DocSearchResult

Use inline fragments to access fields on each type.

ItemSearchResult

Contains a single item result from the search query.

Field	Type	Description
id	`ID!`	The unique identifier of the result.
entity_type	`SearchableEntity!`	The type of entity (`ITEM`).
score	`Float!`	The relevance score of the search result.
data	`IndexedItem!`	Item data from the search index.
live_data	`Item!`	A federation reference to the latest item data from the core API.

BoardSearchResult

Contains a single board result from the search query.

Field	Type	Description
id	`ID!`	The unique identifier of the result.
entity_type	`SearchableEntity!`	The type of entity (`BOARD`).
score	`Float!`	The relevance score of the search result.
data	`IndexedBoard!`	Board data from the search index.
live_data	`Board!`	A federation reference to the latest board data from the core API.

DocSearchResult

Contains a single document result from the search query.

Field	Type	Description
id	`ID!`	The unique identifier of the result.
entity_type	`SearchableEntity!`	The type of entity (`DOCUMENT`).
score	`Float!`	The relevance score of the search result.
data	`IndexedDoc!`	Document data from the search index.
live_data	`Document!`	A federation reference to the latest document data from the core API.

SearchFiltersInput

Top-level filter for the search query, specifying which entities to include and optional global date range filters.

Field	Type	Description
date_range	`CrossEntityDateRangeInput`	Optional. Global date range filter applied to all entity types.
entities	`[SearchEntityFilterInput!]!`	List of entity filters. Each entry is a tagged-union: set one field (`items`, `boards`, `docs`) to include that entity type.

SearchEntityFilterInput

Tagged-union input — set exactly one field per entry to indicate the entity type and its filters.

Field	Type	Description
items	`ItemSearchFilterInput`	Include items in the search with optional item-specific filters.
boards	`BoardSearchFilterInput`	Include boards in the search with optional board-specific filters.
docs	`DocSearchFilterInput`	Include documents in the search with optional doc-specific filters.

ItemSearchFilterInput

Optional filters for narrowing item search results.

Field	Type	Description
board_ids	`[ID!]`	Filter items to specific board IDs.
workspace_ids	`[ID!]`	Filter items to specific workspace IDs.

BoardSearchFilterInput

Optional filters for narrowing board search results.

Field	Type	Description
workspace_ids	`[ID!]`	Filter boards to specific workspace IDs.

DocSearchFilterInput

Optional filters for narrowing document search results.

Field	Type	Description
workspace_ids	`[ID!]`	Filter documents to specific workspace IDs.

CrossEntityDateRangeInput

Global date range filter applied to all entity types in the search query. All fields are optional — provide any combination to narrow results by creation or update timestamps.

Field	Type	Description
created_before	`ISO8601DateTime`	Filter results created before this date (e.g., `"2026-03-16T08:00:00Z"`).
created_after	`ISO8601DateTime`	Filter results created after this date.
updated_before	`ISO8601DateTime`	Filter results updated before this date.
updated_after	`ISO8601DateTime`	Filter results updated after this date.

SearchableEntity

Enum representing the searchable entity types.

Enum Value	Description
`ITEM`	Board items.
`BOARD`	Boards.
`DOCUMENT`	Documents.

IndexedItem

Item data stored in the search index. Returned in the data field of ItemSearchResult.

Field	Type	Description
id	`ID!`	Item ID.
name	`String!`	Item name.
description	`String`	Item description.
board_id	`ID!`	ID of the board containing this item.
board_name	`String!`	Name of the board containing this item.
workspace_id	`ID`	ID of the workspace containing this item.
owner_id	`ID!`	ID of the item owner.
group_id	`ID!`	ID of the group containing this item.
group_name	`String!`	Name of the group containing this item.
created_at	`String!`	ISO 8601 timestamp when the item was created.
updated_at	`String!`	ISO 8601 timestamp when the item was last updated.
url	`String!`	URL to view this item.
type	`String!`	Item type (e.g., `"Project"`).
kind	`String!`	Item kind classification.
board_kind	`String!`	Board kind (e.g., `"public"`, `"private"`).
state	`Int!`	Item state flag.
tags	`[String!]!`	List of tags associated with the item.
column_values	`[EnrichedColumnValues!]!`	The item's column values with metadata.

EnrichedColumnValues

Column value data returned as part of IndexedItem. Includes metadata about column visibility and permissions.

Field	Type	Description
id	`ID!`	Column ID.
col_type	`String!`	Column type.
value	`String!`	Column value.
col_title	`String`	Column title.
is_public	`Boolean!`	Whether the column is publicly visible.
allowed_users	`[String!]!`	List of user IDs allowed to view this column. Empty if the column is public.

IndexedBoard

Board data stored in the search index. Returned in the data field of BoardSearchResult.

Field	Type	Description
id	`ID!`	Board ID.
name	`String!`	Board name.
description	`String`	Board description.
owner_id	`ID!`	ID of the board owner.
workspace_id	`ID`	ID of the workspace containing this board.
created_at	`String!`	ISO 8601 timestamp when the board was created.
updated_at	`String!`	ISO 8601 timestamp when the board was last updated.
url	`String!`	URL to view this board.
type	`String!`	Board type.
kind	`String!`	Board kind (e.g., `"public"`, `"private"`).
board_kind	`String!`	Board kind classification.
state	`Int!`	Board state flag.

IndexedDoc

Document data stored in the search index. Returned in the data field of DocSearchResult.

Field	Type	Description
id	`ID!`	Document ID.
name	`String!`	Document name.
content	`String!`	Document content.
created_at	`String!`	ISO 8601 timestamp when the document was created.
updated_at	`String!`	ISO 8601 timestamp when the document was last updated.