Every monday.com board has one or more columns, each of which holds a particular type of information. These column values are essentially the board's content, and their inner value structure varies based on their type.

As a developer working with monday.com, it is important to familiarize yourself with the column_values API so you know how to access data within columns. This document will walk you through the available queries to read the column_values object via the API.

🚧
Removing column values v1 support
column_values v1 fields will no longer be supported in API versions 2023-10 and later. Check out the updated fields in the column_values v2 doc!

Queries

Querying column_values will return metadata about one or a collection of columns. This method accepts one argument and returns an array.

You can only query column_values by nesting it within another query, so it can't be used at the root. Check out this query in action in our Postman library or follow along with these code samples!

query {
  boards (ids: 1234567890) {
    items (ids: 9876543210) {
      column_values {
        value
        text
      }
    }
  }
}

let query = "query { boards (ids: 1234567890) { items (ids: 9876543210) { column_values { value text }}}}";

fetch ("https://api.monday.com/v2", {
  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)));

📘
Pro tip
Want to change column values on your boards? Check out the Columns reference for a full list of mutations or our detailed guide.

Arguments

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

Argument	Description
ids `[String]`	The specific columns to return.

Fields

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

Field	Description
additional_info `JSON`	The column value's additional information.
description `String`	The column's description.
id `ID!`	The column's unique identifier.
text `String`	The column's textual value.
title `String!`	The column's title.
type `String!`	The column's type.
value `JSON`	The column's value.

Please note: We do not currently support using aliases in the additional_info and text fields. Doing so will return null or an empty result.

📘
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! 😎