---
title: "List item backreferences"
method: GET
path: "/cms/items/{itemId}/backreferences"
tags: ["CMS items"]
---

# List item backreferences

`GET /cms/items/{itemId}/backreferences`

## Request

- Base URL: `https://api.cactal.ai/v1`
- URL: `https://api.cactal.ai/v1/cms/items/{itemId}/backreferences`
- Auth: HTTP bearer

Lists active items that reference the target item through a `reference` or `multi_reference` field, newest first, with cursor pagination (default 20 per page, maximum 100). Each source item appears once even when multiple fields point to the target. `depth` (0–3, default 0) controls reference hydration in the returned source items.

## Path parameters

- `itemId` string, required

## Query parameters

- `cursor` string
- `limit` integer
- `depth` integer

## Response `200`

A page of active items that reference the target item.

- object
  - `items` object[], required
    - `id` string, required: Unique item id.
    - `collectionId` string, required: Id of the owning collection.
    - `slug` string, required: URL-shaped identifier, unique among the collection’s active items. Lowercase letters, digits, and hyphens; max 256 characters.
    - `publishedAt` string, date-time, nullable, required: `null` while the item is a draft or scheduled; the actual publish timestamp otherwise.
    - `publishAt` string, date-time, nullable, required: Future publication time while the item is scheduled; `null` for drafts and published items.
    - `createdAt` string, date-time, required: Creation timestamp.
    - `updatedAt` string, date-time, required: Last-modification timestamp.
    - `position` string, required: Fractional ordering key; the default list order sorts by this value.
    - `data` object, required: 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).
  - `nextCursor` string, nullable, required: Opaque cursor for the next page. Pass it as the `cursor` parameter on the next request. `null` when this is the last page.

## Other responses

- `400`: Validation failed. The response `message` names the first invalid field.
- `401`: Missing, invalid, expired, or revoked API key.
- `403`: The authenticated principal lacks the required capability.
- `404`: The resource does not exist or is outside the principal’s access scope.
- `429`: Rate limit exceeded. Retry after the number of seconds in the `Retry-After` header.

---

[API](https://skmtc.dev/cactal/apis/cactal-api.md) · [All operations](https://skmtc.dev/cactal/apis/cactal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cactal/apis/cactal-api/revisions/9cd0fb5eacdd?raw)