Board views

Learn how to query monday board views using the platform API

monday.com board views allows you to visualize your board data differently. The API can provide records of all views added to a board (except for dashboard views).

Queries

  • Returns an array containing metadata about a collection of board views from a specific board
  • Can only be nested inside a boards query
query {
  boards (ids: 1234567890) {
    views {
      type
      settings_str
      view_specific_data_str
      name
      id
    }
  }
}
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($board: [ID!]) { boards (ids: $board) { views { id name type } } }`
const variables = {
  board: 1234567
}
const response = await mondayApiClient.request(query, variables);

Arguments

You can use the following argument(s) to reduce the number of results returned in your views query.

ArgumentDescription
ids [ID!]The specific board IDs to return views for.
type StringThe specific type of views to return.

Fields

You can use the following field(s) to specify what information your views query will return.

FieldDescriptionEnum values
access_level BoardAccessLevel!The user's board permission level. edit
view
filter JSONThe view's filter metadata. This field is only available in API versions 2025-10 and later.
filter_user_id IntThe user ID the view is filtered by. This field is only available in API versions 2025-10 and later.
filter_team_idThe team ID the view is filtered by. This field is only available in API versions 2025-10 and later.
id ID!The view's unique identifier.
name String!The view's name.
settings_str String!The view's settings.
sortThe view's sort metadata. This field is only available in API versions 2025-10 and later.
source_view_id IDThe unique identifier of the original view this was duplicated from (if applicable).
tagsThe view's tags. This field is only available in API versions 2025-10 and later.
type String!The view's type.
view_specific_data_str String!Specific board view data (only supported for forms).