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 an array of item objects.


    Example code:
    const { SiteClient } = require('datocms-client');
    async function run() {
    const client = new SiteClient('YOUR-API-TOKEN');
    const itemId = '4235';
    const items = await client.item.references(itemId, {
    nested: 'true',
    version: 'current'
    items.forEach((item) => {
    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"