REST API Developer Guide

Introduction to REST API
Quick Start
Examples
Getting Information About My Organization
Working with Object Metadata
Working with Records
Delete Lightning Experience Event Series
Working with Searches and Queries
Get an Image from a Rich Text Area Field
Insert or Update Blob Data
Retrieve Blob Data
Working with Recently Viewed Information
Managing User Passwords
Working with Approval Processes and Process Rules
Using Event Monitoring
Using Composite Resources
Generating an OpenAPI 3.0 Document for sObjects REST API (Beta)
Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Retrieve Blob Data

Use the sObject Blob Retrieve resource to retrieve blob data for a given record. To retrieve blob data, a record with blob data must exist in Salesforce.

Only certain standard objects have blob fields, such as Attachment, ContentNote, ContentVersion, Document, Folder, and Note.

The sObject Blob Retrieve resource isn’t compatible with Composite API requests, because it returns binary data instead of data in JSON or XML formats. Instead, make individual sObject Blob Retrieve requests to retrieve blob data.

Note

The following example retrieves the blob data for the Document record that was created in Insert or Update Blob Data.

Example for retrieving blob data from a Document record

1curl https://MyDomainName.my.salesforce.com/services/data/v56.0/sobjects/Document/015D0000000N3ZZIA0/body -H "Authorization: Bearer token"
Example request body
none required
Example response body
Document body content is returned in binary form. The response content type isn’t JSON or XML since the returned data is binary. You can save the returned binary data to a file to store and access it.