Choose your language:
    Retrieve a record
    Query parameters
    nested  string  Optional

    For Modular Content fields and Structured Text fields. If set, returns full payload for nested blocks instead of IDs

    version  string  Optional

    Whether you want the currently published versions (published, default) of your records, or the latest available (current)

    Returns a item object.


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