Item ID

Learn how to read the item ID column on monday boards using the platform API

The item ID column represents the unique identifier assigned to each item. The API allows you to read the item ID column. You can also read an item's ID by querying id on any field with the Item type.

Read an item ID column

You can query the item ID column using the column_values object that enables you to return column-specific subfields by sending a fragment in your query. Values for the item ID column are of the ItemIdValue type.

query {
  items (ids:[1234567890, 9876543210]) {
    column_values {
      ... on ItemIdValue {
        value
        text
      }
    }
  }
}
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query($itemIds: [ID!], $columnType:[ColumnType!]) { items (ids:$itemIds) { id column_values (types:$columnType) { column { title id } ... on ItemIdValue { item_id } } } }`;
const variables = {
  itemIds: [9571351485, 9572374902],
  columnType: "item_id"
};

const response = await mondayApiClient.request(query, variables);

Fields

FieldDescription
column Column!The column the value belongs to.
id ID!The column's unique identifier.
item_id ID!The item's unique identifier.
text StringThe column's value as text.
type ColumnType!The column's type.
value JSONThe column's JSON-formatted raw value.