The item ID column represents the unique identifier assigned to each item. Our API partially supports the item ID column, so you can only read it via the API.

Reading the item ID column

You can query the item ID column using the column_values object. The object has different fields based on which API version you are using. Column values v2 fields will be available in API versions 2023-10 and later, while column values v1 fields are only supported in versions 2023-07 and 2023-04.

Column values v2

The column_values object 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.


Pro tip

column_values v2 fields are only available in API version 2023-10.

query {
  items (ids:[1234567890, 9876543210]) {
    column_values {
      ... on ItemIdValue {


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.
updated_at DateThe column's last updated date.
value JSONThe column's JSON-formatted raw value.


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