Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Get Records Using sObject Collections

Use a GET request with sObject Collections to get one or more records of the same object type. A list of sObjects that represents the individual records of the specified type is returned. The number of sObjects returned matches the number of IDs passed in the request.

You can specify approximately 800 IDs before the URL length causes the HTTP 414 error URI too long.

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

If you specify an invalid field name or a field name that you don’t have permission to read, HTTP 400 Bad Request is returned.
If you don’t have access to an object, or if a passed ID is invalid, the array returns null for that object.

Syntax

URI: /services/data/vXX.X/composite/sobjects/sObject

Formats: JSON, XML

HTTP Method: GET

Authentication: Authorization: Bearer token

Parameters

Parameter	Description
ids	Required. A list of one or more IDs of the objects to return. All IDs must belong to the same object type.
fields	Required. A list of fields to include in the response. The field names you specify must be valid, and you must have read-level permissions to each field.

Example

Example Request

1curl https://MyDomainName.my.salesforce.com/services/data/v67.0/composite/sobjects/Account?ids=001xx000003DGb1AAG,001xx000003DGb0AAG,001xx000003DGb9AAG&fields=id,name -H "Authorization: Bearer token"

Example Response Body

1[
2   {
3      "attributes" : {
4         "type" : "Account",
5         "url" : "/services/data/v67.0/sobjects/Account/001xx000003DGb1AAG"
6      },
7      "Id" : "001xx000003DGb1AAG",
8      "Name" : "Acme"
9   },
10   {
11      "attributes" : {
12         "type" : "Account",
13         "url" : "/services/data/v67.0/sobjects/Account/001xx000003DGb0AAG"
14      },
15      "Id" : "001xx000003DGb0AAG",
16      "Name" : "Global Media"
17   },
18   null
19]

REST API Developer Guide

Get Records Using sObject Collections

Syntax

Example