Get Records With a Request Body Using sObject Collections
Use a POST 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.
The request retrieves up to 2,000 records of the same object type
- If you specify an invalid field name or a field name that you don’t have permission to read,
HTTP 400 Bad Requestis returned. - If you don’t have access to an object, or if a passed ID is invalid, the array returns null for that object.
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.
URI: /services/data/vXX.X/composite/sobjects/sObject
Formats: JSON, XML
HTTP Method: POST
Authentication: Authorization: Bearer token
Request Body
Parameters
| Parameter | Description |
|---|---|
recordIds | Required. A list of one or more IDs of the objects to return. All IDs must belong to the same object type. |
fieldNames | 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 Request
Example Request Body
Example Response Body