Content Management API > Record
Referenced records
List all records that link to a specific record
Query parameters
nested boolean
For Modular Content, Structured Text and Single Block fields, return full payload for nested blocks instead of IDs
version null, enum
Retrieve only the selected type of version that is linked to the record; current, published or both
Example:
"current"
current
Return records that in their latest version available link to the record
published
Return records that in their published version link to the record
published-or-current
Return records that either in their published version or in their latest version available link to the record
Returns
Returns an array of resource objects of type item
Examples
import { buildClient } from "@datocms/cma-client-node";
async function run() { const client = buildClient({ apiToken: process.env.DATOCMS_API_TOKEN });
const itemId = "hWl-mnkWRYmMCSTq4z_piQ";
const items = await client.items.references(itemId);
for (const item of items) { // Check the 'Returned output' tab for the result ☝️ console.log(item); }}
run();{ id: "hWl-mnkWRYmMCSTq4z_piQ", title: "My first blog post!", content: "Lorem ipsum dolor sit amet...", category: "24", image: { alt: "Alt text", title: "Image title", custom_data: {}, focal_point: null, upload_id: "20042921", }, meta: { created_at: "2020-04-21T07:57:11.124Z", updated_at: "2020-04-21T07:57:11.124Z", published_at: "2020-04-21T07:57:11.124Z", first_published_at: "2020-04-21T07:57:11.124Z", publication_scheduled_at: "2020-04-21T07:57:11.124Z", unpublishing_scheduled_at: "2020-04-21T07:57:11.124Z", status: "published", is_current_version_valid: true, is_published_version_valid: true, current_version: "4234", stage: null, has_children: true, }, item_type: { type: "item_type", id: "DxMaW10UQiCmZcuuA-IkkA" },}