List Views for an Object

Returns the list of list views for the specified sObject, including the ID and other basic information about each list view. This resource is available in REST API version 32.0 and later.

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

Formats: JSON, XML

HTTP Methods: GET

Authentication: Authorization: Bearer token

Parameters: None

Example

Example Request

1curl https://MyDomainName.my.salesforce.com/services/data/v67.0/sobjects/Account/listviews -H "Authorization: Bearer token"

Example Response Body

1{
2  "done" : true,
3  "listviews" : [ {
4    "describeUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcBeMAK/describe",
5    "developerName" : "NewThisWeek",
6    "id" : "00BD0000005WcBeMAK",
7    "label" : "New This Week",
8    "resultsUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcBeMAK/results",
9    "soqlCompatible" : true,
10    "url" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcBeMAK"
11  }, {
12    "describeUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcBpMAK/describe",
13    "developerName" : "NewLastWeek",
14    "id" : "00BD0000005WcBpMAK",
15    "label" : "New Last Week",
16    "resultsUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcBpMAK/results",
17    "soqlCompatible" : true,
18    "url" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcBpMAK"
19  }, {
20    "describeUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcC6MAK/describe",
21    "developerName" : "PlatinumandGoldSLACustomers",
22    "id" : "00BD0000005WcC6MAK",
23    "label" : "Platinum and Gold SLA Customers",
24    "resultsUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcC6MAK/results",
25    "soqlCompatible" : true,
26    "url" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcC6MAK"
27  }, {
28    "describeUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcCEMA0/describe",
29    "developerName" : "RecentlyViewedAccounts",
30    "id" : "00BD0000005WcCEMA0",
31    "label" : "Recently Viewed Accounts",
32    "resultsUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcCEMA0/results",
33    "soqlCompatible" : true,
34    "url" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcCEMA0"
35  }, {
36    "describeUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcCFMA0/describe",
37    "developerName" : "AllAccounts",
38    "id" : "00BD0000005WcCFMA0",
39    "label" : "All Accounts",
40    "resultsUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcCFMA0/results",
41    "soqlCompatible" : true,
42    "url" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcCFMA0"
43  }, {
44    "describeUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcCNMA0/describe",
45    "developerName" : "MyAccounts",
46    "id" : "00BD0000005WcCNMA0",
47    "label" : "My Accounts",
48    "resultsUrl" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcCNMA0/results",
49    "soqlCompatible" : true,
50    "url" : "/services/data/v67.0/sobjects/Account/listviews/00BD0000005WcCNMA0"
51  } ],
52  "nextRecordsUrl" : null,
53  "size" : 6,
54  "sobjectType" : "Account"
55}

REST API Developer Guide

List Views for an Object

Example