Newer Version Available

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

Work with List Views

Use the List View resources to get record data and metadata about list views displayed in the Salesforce UI.
Get Record Data and Metadata for a List View

As an example, let’s say we have a list view named All Accounts with a list view ID of 00BR0000000Wc0rMAC. To get information about all the records and metadata for this list view, make this request.

You can also use the object API name and list view API name of the list view to make the same request.

The request returns a list of records and the metadata for the list view.

Modify the List View Results

To modify the results returned by the List View resources, use the following request parameters:

  • fields—Additional fields queried for the records returned, for display purposes. If a field is specified and the user doesn’t have access to it, an error occurs.
  • optionalFields—Additional fields queried for the records returned, for display purposes. If a field is specified and the user doesn’t have access to it, no error occurs.
  • pageSize—The number of list records viewed at one time.
  • pageToken—A token that represents the page offset.
  • sortBy—The API name of the field the list view is sorted by.

For example, to sort records by the date they were created, set the sortBy parameter to CreatedDate.

Depending on the list view object, some extra fields that were not requested in the fields or optionalFields parameters can be returned. For example, if person accounts are enabled for the org, a request to get list view records can return the isPersonAccount field, among others.

Note