Choose your language:
    Referenced records

    List all records that link to a specific record

    Query parameters
    nested  enum  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
    Returns an array of item objects.

    Examples

    Example code:
    const SiteClient = require('datocms-client').SiteClient;
    const client = new SiteClient('YOUR-API-TOKEN');
    const itemId = '4235';
    client.item.references(itemId, {
    nested: 'true',
    version: 'current'
    })
    .then((items) => {
    items.forEach((item) => {
    console.log(item);
    });
    })
    .catch((error) => {
    console.error(error);
    });
    Returned output:
    > node example.js
    {
    "id": "4235",
    "title": "My first blog post!",
    "content": "Lorem ipsum dolor sit amet...",
    "category": "24",
    "image": {
    "alt": "Alt text",
    "title": "Image title",
    "customData": {},
    "focalPoint": null,
    "uploadId": "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_valid": true,
    "current_version": "4234",
    "stage": ""
    },
    "itemType": "44",
    "creator": "312"
    }