The monday.com search API allows you to find items, boards, and documents across your account in a single query. It uses a combination of keyword matching and semantic understanding to return the most relevant results.

You can search multiple entity types simultaneously, apply per-entity filters (e.g., search items only on specific boards), and narrow results using global date range filters. Results are ordered by relevance score within each entity type.

🚧
Only available in API versions 2026-07 and later

📘
Check out the Searching across your account guide for best practices, filtering strategies, and end-to-end examples.

Queries

Search across entities

Required scopes vary by result type:

Result type	Required scope
`ItemSearchResult`	`boards:read`
`BoardSearchResult`	`boards:read`
`DocSearchResult`	`docs:read`

Returns [SearchResult!] — a union of ItemSearchResult, BoardSearchResult, and DocSearchResult
Can be queried directly at the root
Each entity type set in the filters argument will be included in the search. Omit an entity type to exclude it from results.
The limit argument applies per entity type — setting limit: 10 returns up to 10 items, 10 boards, and 10 documents.

Use inline fragments to select fields for each result type:

query {
  search(
    query: "Q1 planning"
    limit: 10
    filters: {
      date_range: {
        created_after: "2025-01-01T00:00:00.000Z"
        updated_before: "2025-06-30T23:59:59.999Z"
      }
      entities: [
        { items: { board_ids: ["1234567890"] } }
        { boards: {} }
        { docs: {} }
      ]
    }
  ) {
    ... on ItemSearchResult {
      id
      entity_type
      score
      data {
        id
        name
        board_id
        board_name
      }
    }
    ... on BoardSearchResult {
      id
      entity_type
      score
      data {
        id
        name
      }
    }
    ... on DocSearchResult {
      id
      entity_type
      score
      data {
        id
        name
      }
    }
  }
}

Arguments

Argument	Type	Description
query	`String!`	The search query string.
limit	`Int!`	Maximum number of results to return per entity type. Maximum value: `100`.
filters	`SearchFiltersInput!`	Filters specifying which entities to search and their per-entity filters.

Fields

The search query returns [SearchResult!] — a union type. Use inline fragments to access fields on each result type.

Each result type shares these common fields:

Field	Type	Description
id	`ID!`	The unique identifier of the result.
entity_type	`SearchableEntity!`	The type of entity: `ITEM`, `BOARD`, or `DOCUMENT`.
score	`Float!`	A relevance score for the search result. Higher values indicate greater relevance within the same entity type.
data	`IndexedItem!` / `IndexedBoard!` / `IndexedDoc!`	The entity data stored in the search index. The type depends on the result type. See Object types.
live_data	`Item!` / `Board!` / `Document!`	A federation reference to the latest entity data from the core API. Use this to access real-time fields not available in the indexed `data`.

👍
data vs live_data
The data field returns pre-indexed data from the search index — fast but potentially stale. The live_data field resolves to the full entity from the core API (e.g., Item, Board, Document) with the latest data, but requires an additional federation call.

Authorization

The search API uses two-phase authorization:

Pre-authorization — Results are filtered to entities within workspaces and boards the user has access to.
Post-authorization — Column-level visibility filtering removes columns the user cannot see based on column permissions.

All authorization is applied automatically based on the authenticated user context.

Limits

Constraint	Value
Maximum results per entity type	`100`

Results are returned ordered by relevance within each entity type. No cursor-based pagination is available — all results are returned up to the specified limit.