Show examples in:
    Referenced records

    List all records that link to a specific record

    Query parameters

    nested  Optional  boolean  Example: true

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

    version  Optional  null, enum  Example: "current"

    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 = 'hWl-mnkWRYmMCSTq4z_piQ';
    const items = await client.items.references(itemId, {
    nested: true,
    version: 'current'
    items.forEach((item) => {
    Returned output:
    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: 'draft',
    is_current_version_valid: true,
    is_published_version_valid: true,
    current_version: '4234',
    stage: ''
    item_type: {
    type: 'item_type',
    id: 'DxMaW10UQiCmZcuuA-IkkA'
    creator: {
    type: 'account',
    id: '312'