Column Values

Every monday.com board has one or more columns, each of which holds a particular type of information. These column values are essentially the content of the board.

Their inner value structure varies by their type. You can learn more details about columns here.

Column values are available for querying through parent items. They must be nested within another query, like an item. You cannot use them at the root of your query.

query {
  boards (limit: 5) {
    items (limit: 50) {
      column_values {
        id
        value
      }
        }
    }
}
let query = "query { items (limit: 50) { column_values { id value }}}";

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)));
curl --location --request POST 'https://api.monday.com/v2' \
--header 'Authorization: YourSuperSecretAPIkey' \
--header 'Content-Type: application/json' \
--data-raw '{"query":"query { items (limit: 50) { column_values { id value }}}"}'

πŸ“˜

Want to change column values on your boards?

Check out the Columns reference for a full list of mutations, or our detailed guide.

Arguments

The following column values argument can reduce the number of values returned.

Argument

Description

IDs [String]

A list of the unique column identifier(s).

Fields

The following fields will determine what information is returned from your column_values() queries.

Field

Description

additional_info JSON

The column value's additional information.

id !ID

The column's unique identifier.

text String

The column's textual value in string form.

title !String

The column's title.

type !String

The column's type.

value JSON

The column's value in json format.

πŸ“˜

Do you have questions?

Join our developer community! You can share your questions and learn from fellow users and monday.com product experts.

Don’t forget to search before opening a new topic!


Did this page help you?