Show examples in:
    Referenced records

    List all records that link to a specific record

    Query parameters

    nested  boolean  Optional

    For Modular Content fields and Structured Text fields, return full payload for nested blocks instead of IDs

    version  null, enum  Optional

    Retrieve only the selected type of version that is linked to the record; current, published or both


    Returns an array of item resource objects.


    Example code:
    import { buildClient } from '@datocms/cma-client-node';
    async function run() {
    const client = buildClient({ apiToken: '<YOUR_API_TOKEN>' });
    const itemId = '4235';
    const items = await client.items.references(itemId, {
    nested: true,
    version: 'current'
    items.forEach((item) => {
    Returned output:
    id: '4235',
    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: 'draft',
    is_current_version_valid: true,
    is_published_version_valid: true,
    current_version: '4234',
    stage: ''
    item_type: {
    type: 'item_type',
    id: '44'
    creator: {
    type: 'account',
    id: '312'