Board views board views allow you to visualize your board data differently. For example, you could see all events on a board in a Calendar View to easily see what's coming up in your schedule or use the Charts View to get reports from your data. The API will provide you with records of all views added to a board.

As a developer working with, it is important to familiarize yourself with the views API so you know how to access board view data. This document will walk you through the available queries to read the views object via the API.


Querying views will return a collection of board views from a specific board. This method accepts various arguments and returns an array.

You can only query views by nesting it within a boards query, so it can't be used at the root.

query {
	boards (ids: 1234567890) {
		views {
let query = 'query { boards (ids: 1234567890) { views { id name type } } }';

fetch ("", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY_HERE'
   body: JSON.stringify({
     'query' : query
   .then(res => res.json())
   .then(res => console.log(JSON.stringify(res, null, 2)));

This query would return the following:

  "data": {
    "boards": [
        "views" : [
            "type": "FormBoardView",
            "settings_str": "{\"columns\":{\"name\":{\"visible\":true,\"question\":\"Name\",\"type\":\"name\"},\"email\":{\"visible\":true,\"question\":\"Email\",\"type\":\"email\"},\"phone\":{\"visible\":true,\"question\":\"Phone\",\"type\":\"phone\"},\"location\":{\"visible\":true,\"question\":\"Location\",\"type\":\"location\"},\"text6\":{\"visible\":true,\"question\":\"T-shirt Size\",\"type\":\"text\"},\"pulse__update\":{\"visible\":false,\"question\":\"Update\"},\"status8\":{\"visible\":true,\"question\":\"Status\",\"type\":\"color\"}},\"formTitle\":\"Contact Info and T-shirt Form\",\"show_name_question\":true,\"backgroundColor\":\"chili-blue\",\"headerColor\":null,\"createdBy\":31855020}",
            "view_specific_data_str": "{\"token\":\"abcdefg12345678\",\"disabled\":false,\"region\":\"use1\"}",
            "name": "Contact Form",
            "id": "55567306"
            "type": "ItemsGalleryBoardView",
            "settings_str": "{}",
            "view_specific_data_str": "{}",
            "name": "Cards",
            "id": "212647324"
            "type": "KanbanBoardView",
            "settings_str": "{\"pivot_by_column\":{\"status8\":true},\"assignee_column\":{},\"gallery_column\":{\"all\":true},\"card_columns\":{\"person\":true,\"date\":true,\"subitems\":true},\"display_mode\":\"crop\",\"divide_by_column\":{\"group\":true},\"createdBy\":31855020}",
            "view_specific_data_str": "{}",
            "name": "Kanban",
            "id": "212644479"


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

ids [Int]The specific board IDs to return views for. Please note that this argument's type is [ID!] in API versions 2023-10 and later.
type StringThe specific type of views to return.


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

id ID!The view's unique identifier.
name String!The view's name.
settings_str String!The view's settings.
type String!The view's type.
view_specific_data_str String!Specific board view data (only supported for forms).


Join our developer community!

We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎