Get an item
Returns one item, looked up by itemId or by the collectionId + slug pair (provide exactly one of the two). The data object is complete and schema-shaped: every currently-defined field is present and missing optional values read as null. depth (0–3, default 0) embeds referenced items in place of their ids, one level per unit; referenced items that were deleted read as null (single reference) or are omitted from arrays (multi-reference). Set published to "true" or "false" to match only a published or only a draft item (a mismatch reads as not found). List items that reference it with cms.items.backreferences.list.
Authorizations
Cactal API key. Create one in the dashboard or via POST /apiKeys. The plaintext key is shown once at creation.
Query Parameters
Item id. Provide either this or the collectionId + slug pair.
1Collection to look the item up in by slug. Pair with slug.
1Item slug within the collection. Pair with collectionId.
^[a-z0-9][a-z0-9-]{0,255}$0 <= x <= 3Only match a published ("true") or draft ("false") item; a mismatch reads as not found. Omit to match either.
"true"Response
The item, hydrated to the requested depth.
Unique item id.
URL-shaped identifier, unique among the collection’s active items. Lowercase letters, digits, and hyphens; max 256 characters.
null while the item is a draft or scheduled; the actual publish timestamp otherwise.
Future publication time while the item is scheduled; null for drafts and published items.
Creation timestamp.
Last-modification timestamp.
Fractional ordering key; the default list order sorts by this value.
One entry per field of the collection, keyed by field key; optional fields with no value read as null. Scalar fields use plain JSON values: date as an ISO 8601 string, color as normalized hex, option as a choice id (or array of ids when multi-select). reference values are the referenced item id at depth 0 or an embedded item object (this same item shape) at depth ≥ 1; multi_reference values are ordered arrays of the same. image and gallery values resolve to image objects carrying id, delivery url, originalUrl, srcSet, variants, dimensions, filename, mimeType, byteSize, and altText; file values resolve to { id, url, filename, mimeType, byteSize }. Unset asset fields read as null (or [] for galleries).