Get Records Using sObject Collections

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

• 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

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

Example Response Body

[
   {
      "attributes" : {
         "type" : "Account",
         "url" : "/services/data/v63.0/sobjects/Account/001xx000003DGb1AAG"
      },
      "Id" : "001xx000003DGb1AAG",
      "Name" : "Acme"
   },
   {
      "attributes" : {
         "type" : "Account",
         "url" : "/services/data/v63.0/sobjects/Account/001xx000003DGb0AAG"
      },
      "Id" : "001xx000003DGb0AAG",
      "Name" : "Global Media"
   },
   null
]