Newer Version Available
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.