Box Developer Documentation

Query item fields

Query item fields

Item fields are searchable metadata fields that describe items (files and folders) in Box. These fields expose built-in item properties such as name, type, owner, and timestamps with defined data types so you can filter, sort, and search Box content.

Supported item fields

The following table lists the item fields you can use in metadata queries.

Field nameDescriptionSorting
item.typeType of the item: file or folderYes
item.nameName of the itemYes
item.descriptionDescription of the itemYes
item.extensionFile extension, such as pdf, jpeg, xlsx, txt, xls, png, log, or csvYes
item.owned_byOwner of the item, for example user_123Yes
item.owner_enterprise_idEnterprise ID of the item owner, for example 1234Yes
item.created_atDate and time when the item was created in BoxYes
item.modified_atDate and time when the item was last updated in BoxYes
item.content_created_atDate and time when the item was originally created, which might be before it was uploaded to BoxYes
item.content_modified_atDate and time when the item was last updated, which might be before it was uploaded to BoxYes
item.quick_search_contentFull-text search across item name, description, and metadata fieldsNo