REST API Developer Guide
jNewer Version Available
Reference
The following table lists supported REST resources in the API and provides a brief description for each. In each case, the URI for the resource follows the base URI, https://MyDomainName.my.salesforce.com.
For example, to retrieve basic information about an Account object in version 53.0 use https://MyDomainName.my.salesforce.com/services/data/v53.0/sobjects/Account.
Some of these resources are only available if you have the corresponding package installed or have the corresponding feature enabled.
| Resource Name | URI and Description |
|---|---|
| Versions |
/services/data Lists summary information about each Salesforce version currently available, including the version, label, and a link to each version's root. |
| Resources by Version |
/services/data/vXX.X Lists available resources for the specified API version, including resource name and URI. |
| Invocable Actions |
/services/data/vXX.X/actions/standard /services/data/vXX.X/actions/custom Use actions to add more functionality to your applications. Choose from standard actions, such as posting to Chatter or sending email, or create actions based on your company’s needs. |
| Analytics (Accesses Reports and Dashboards REST API) |
/services/data/vXX.X/analytics Accesses Reports and Dashboards REST API resources. See the Salesforce Reports and Dashboards REST API Developer Guide. |
| AppMenu |
/services/data/vXX.X/appMenu/AppSwitcher /services/data/vXX.X/appMenu/Salesforce1 Returns a list of items in either the Salesforce app drop-down menu or the Salesforce for Android, iOS, and mobile web navigation menu. |
| Asset Management |
/services/data/vXX.X/asset-management Makes make lifecycle-managed asset data available for sales and account reps to view in Lightning Experience. See Customer Asset Lifecycle Management in the Connect REST API Developer Guide. |
| Async Queries |
/services/data/vXX.X/async-queries Submits a SOQL query to be processed asynchronously. See
|
| Chatter (Connect REST API) |
/services/data/vXX.X/chatter Accesses features in the Connect REST API. See the Connect REST API Developer Guide. |
| Commerce (Place Order REST API) |
/services/data/vXX.X/commerce Accesses features in the Place Order REST API. See the Place Order REST API Developer Guide. |
| Compact Layouts |
/services/data/vXX.X/compactLayouts?q=objectList Returns a list of compact layouts for multiple objects. |
| Composite |
/services/data/vXX.X/composite Executes a series of REST API requests in a single call. You can use the output of one request as the input to a subsequent request. The response bodies and HTTP statuses of the requests are returned in a single response body. The entire series of requests counts as a single call toward your API limits. |
| Composite Batch | /services/data/vXX.X/composite/batch Executes up to 25 subrequests in a single request. |
| Composite Graphs |
/services/data/vXX.X/composite/graph Provides an enhanced way to perform composite requests. |
| sObject Tree |
/services/data/vXX.X/composite/tree Creates one or more sObject trees with root records of the specified type. An sObject tree is a collection of nested, parent-child records with a single root record. |
| sObject Collections |
/services/data/vXX.X/composite/sobjects Executes actions on multiple records in one request. |
| Connect REST API |
/services/data/vXX.X/connect Accesses features in the Connect REST API. See the Connect REST API Developer Guide. |
| Financial Services |
/services/data/vXX.X/connect/financialservices Accesses Financial Services objects. See the Financial Services Cloud Developer Guide. |
| Health Cloud |
/services/data/vXX.X/connect/health/care-services Accesses Health Cloud objects. See the Health Cloud Developer Guide. |
| Manufacturing |
/services/data/vXX.X/connect/manufacturing Accesses Manufacturing Cloud objects. See the Manufacturing Cloud Developer Guide. |
| Consumer Goods |
/services/data/vXX.X/connect/object-detection /services/data/vXX.X/connect/visit/recommendations Accesses the Consumer Goods Business API. See the Consumer Goods Cloud Developer Guide. |
| Consent |
/services/data/vXX.X/consent Tracks users’ consent preferences. |
| Contact Tracing |
/services/data/vXX.X/contact-tracing Tracks health contacts. See the Emergency Response Management for Public Health Developer Guide. |
| Dedupe |
/services/data/vXX.X/dedupe Lists duplicate resources, job definitions, and jobs. See the Connect REST API Developer Guide. |
| Domino |
/services/data/vXX.X/domino For internal use only. |
| Eclair (geodata) |
/services/data/vXX.X/eclair Accesses geodata definitions. See Charts Geodata Resource in the Tableau CRM REST API Developer Guide. |
| Email Connect |
/services/data/vXX.X/emailConnect For internal use only. |
| Platform Event Schema by Schema ID |
/services/data/vXX.X/event/eventSchema/schemaId Gets the definition of a platform event in JSON format for a schema ID. |
| Folders |
/services/data/vXX.X/folders Use the Analytics Folders API to perform operations on report and dashboard folders. See Folders in the Reports and Dashboards REST API Developer Guide. |
| IoT |
/services/data/vXX.X/iot Accesses features in the IoT REST API. See the IoT REST API Getting Started Guide. |
| Jobs (Bulk API 2.0) |
/services/data/vXX.X/jobs Accesses jobs in the Bulk API 2.0. See the Bulk API 2.0 and Bulk API Developer Guide. |
| jsonxform (Tableau CRM REST API) |
/services/data/vXX.X/jsonxform Tests the results of a rule in a Tableau template. See Rules Testing with jsonxform/transformation endpoint the Tableau CRM Templates Developer Guide. |
| Knowledge Management |
/services/data/vXX.X/knowledgeManagement Accesses Salesforce Knowledge features. See the Knowledge Developer Guide. |
| Licensing |
/services/data/vXX.X/licensing For internal use only. |
| Limits |
/services/data/vXX.X/limits Lists information about limits in your org. For each limit, this resource returns the maximum allocation and the remaining allocation based on usage. |
| Record Count |
/services/data/vXX.X/limits/recordCount Lists information about object record counts in your organization. |
| Salesforce Surveys Translation Resources |
/services/data/vXX.X/localizedvalue Use REST APIs to translate survey fields, view, update, or delete translated survey fields. The translated values of surveys fields are stored in Flow fields. |
| Metadata |
/services/data/vXX.X/metadata Accesses features in the Metadata API. See the Metadata API Developer Guide. |
| Parameterized Search |
/services/data/vXX.X/parameterizedSearch/?q=searchString Executes a simple RESTful search using parameters instead of a SOSL clause. Indicate parameters in a URL in the GET method. Or, use POST for more complex JSON searches. |
| Payments |
/services/data/vXX.X/payments For internal use only. |
| Process Approvals |
/services/data/vXX.X/process/approvals Returns a list of all approval processes. Can also be used to submit a particular record if that entity supports an approval process and one has already been defined. Records can be approved and rejected if the current user is an assigned approver. |
| Process Rules |
/services/data/vXX.X/process/rules Returns a list of all active workflow rules. If a rule has actions, the actions will be listed under the rule. Can also be used to trigger all workflow rules that are associated with a specified record. The actions for a rule are only fired if the rule’s criteria is met. |
|
Query
(SOQL) |
/services/data/vXX.X/query/?q=soql Executes the specified SOQL query. |
|
QueryAll
(SOQL) |
/services/data/vXX.X/queryAll/?q=soql Executes the specified SOQL query. Results can include deleted, merged and archived records. |
| Quick Actions |
/services/data/vXX.X/quickActions Returns a list of global quick actions and their types, as well as custom fields and objects that appear in the Chatter feed. |
| Recently Viewed Items |
/services/data/vXX.X/recent Gets the most recently accessed items that were viewed or referenced by the current user. |
| Salesforce Scheduler Resources |
/services/data/vXX.X/scheduling/ Accesses Scheduler REST APIs to get appointment time slots or available service resources based on work type groups and service territories. |
|
Search
(SOSL) |
/services/data/vXX.X/search/?q=sosl Executes the specified SOSL search. The search string must be URL-encoded. |
| Search Scope and Order |
/services/data/vXX.X/search/scopeOrder Returns an ordered list of objects in the default global search scope of a logged-in user. Global search keeps track of which objects the user interacts with and how often and arranges the search results accordingly. Objects used most frequently appear at the top of the list. |
| Search Suggested Queries |
/services/data/vXX.X/search/suggestSearchQueries?q=searchString&language=languageOfQuery Returns a list of suggested searches based on the user’s query string text matching searches that other users have performed in Salesforce Knowledge. Provides a way to improve search effectiveness, before the user performs a search. |
| Search Suggested Article Title Matches |
/services/data/vXX.X/search/suggestTitleMatches?q=searchString&language=articleLanguage&publishStatus=articlePublicationStatus Returns a list of Salesforce Knowledge article titles that match the user’s search query string. Provides a shortcut to navigate directly to likely relevant articles before the user performs a search. |
| Search Result Layouts |
/services/data/vXX.X/searchlayout/?q=commaDelimitedObjectList Returns search result layout information for the objects in the query string. For each object, this call returns the list of fields displayed on the search results page as columns, the number of rows displayed on the first page, and the label used on the search results page. |
| Service Templates |
/services/data/vXX.X/serviceTemplates For internal use only. |
| Smart Data Discovery (Insights API) |
/services/data/vXX.X/smartdatadiscovery Uses the Insights API to embed insights into a website, application, or dashboard. See Get Descriptive and Diagnostic Insights Programmatically. |
| Describe Global |
/services/data/vXX.X/sobjects Lists the available objects and their metadata for your organization’s data. |
| Platform Event Schema by Event Name |
/services/data/vXX.X/sobjects/eventName/eventSchema Gets the definition of a platform event in JSON format for an event name. |
| Lightning Exit by Page Metrics |
/services/data/vXX.X/sobjects/LightningExitByPageMetrics Returns frequency metrics about the standard pages within which users switched from Lightning Experience to Salesforce Classic. |
| Lightning Toggle Metrics |
/services/data/vXX.X/sobjects/LightningToggleMetrics Returns details about users who switched between Salesforce Classic and Lightning Experience. |
| Lightning Usage by App Type |
/services/data/vXX.X/sobjects/LightningUsageByAppTypeMetrics Returns the total number of Lightning Experience and Salesforce Mobile users. |
| Lightning Usage by Browser |
/services/data/vXX.X/sobjects/LightningUsageByBrowserMetrics Returns Lightning Experience usage results grouped by browser instance. |
| Lightning Usage by FlexiPage |
/services/data/vXX.X/sobjects/LightningUsageByFlexiPageMetrics Returns details about the custom pages viewed most frequently in Lightning Experience. |
| Lightning Usage by Page |
/services/data/vXX.X/sobjects/LightningUsageByPageMetrics Represents standard pages users viewed most frequently in Lightning Experience. |
| sObject PlatformAction |
/services/data/vXX.X/sobjects/PlatformAction Queries for actions displayed in the UI, given a user, a context, device format, and a record ID. Examples include standard and custom buttons, quick actions, and productivity actions. |
| sObject Relevant Items | Gets the current user’s most relevant items. Relevant items include records for objects in the user’s global search scope and also most recently used (MRU) objects. |
| sObject Basic Information |
/services/data/vXX.X/sobjects/sObject Describes the individual metadata for the specified object. Can also be used to create a new record for a given object. |
| sObject Get Deleted |
/services/data/vXX.X/sobjects/sObject/deleted/?start=startDateAndTime&end=endDateAndTime Retrieves the list of individual records that have been deleted within the given timespan for the specified object. |
| sObject Describe |
/services/data/vXX.X/sobjects/sObject/describe Completely describes the individual metadata at all levels for the specified object. |
| sObject ApprovalLayouts |
/services/data/vXX.X/sobjects/sObject/describe/approvalLayouts Returns a list of approval layouts for a specified object. |
| sObject CompactLayouts |
/services/data/vXX.X/sobjects/sObject/describe/compactLayouts Returns a list of compact layouts for a specific object. |
| sObject Describe Layouts | /services/data/vXX.X/sobjects/sObject/describe/layouts /services/data/vXX.X/sobjects/Global/describe/layouts Returns a list of global publisher layouts and descriptions. You can request descriptions for a specific object or for all publisher layouts. Layout names and a list of fields are returned. Global publisher layouts customize the actions on global pages (like the Home page). In Lightning Experience, these layouts populate the Global Actions menu. |
| sObject Named Layouts |
/services/data/vXX.X/sobjects/sObject/describe/namedLayouts/layoutName Retrieves information about alternate named layouts for a given object. |
| sObject Rows by External ID |
/services/data/vXX.X/sobjects/sObject/fieldName/fieldValue Creates new records or updates existing records (upserts records) based on the value of a specified external ID field. |
| List Views |
/services/data/vXX.X/sobjects/sObject/listviews /services/data/vXX.X/sobjects/sObject/listviews/listViewId Returns the list of list views for the specified sObject, including the ID and other basic information about each list view. You can also get basic information for a specific list view by ID. |
| List View Results |
/services/data/vXX.X/sobjects/sObject/listviews/listViewID/results Executes the SOQL query for the list view and returns the resulting data and presentation information. |
| List View Describe |
/services/data/vXX.X/sobjects/sObject/listviews/queryLocator/describe Returns detailed information about a list view, including the ID, the columns, and the SOQL query. |
| Recent List Views |
/services/data/vXX.X/sobjects/sObject/listviews/recent Returns the list of recently used list views for the given object. |
| sObject Quick Actions |
/services/data/vXX.X/sobjects/sObject/quickActions/ Returns a list of actions and their details. |
| sObject Get Updated |
/services/data/vXX.X/sobjects/sObject/updated/?start=startDateAndTime&end=endDateAndTime Retrieves the list of individual records that have been updated (added or changed) within the given timespan for the specified object. |
| sObject Rows |
/services/data/vXX.X/sobjects/sObject/id Accesses records based on the specified object ID. Retrieves, updates, or deletes records. This resource can also be used to retrieve field values. |
| sObject Blob Retrieve |
/services/data/vXX.X/sobjects/sObject/id/blobField Retrieves the specified blob field from an individual record and returns it as binary data. |
| sObject Relationships |
/services/data/vXX.X/sobjects/sObject/id/relationshipName Accesses records by traversing object relationships via friendly URLs. You can retrieve, update, or delete the record associated with the traversed relationship field. If there are multiple related records, you can retrieve the complete set of associated records. |
| sObject Rich Text Image Retrieve |
/services/data/vXX.X/sobjects/sObject/id/richTextImageFields/fieldName/contentReferenceId Retrieves the specified image data from a specific rich text area field in a given record. |
| sObject Suggested Articles |
/services/data/vXX.X/sobjects/sObject/ID/suggestedArticles?language=articleLanguage /services/data/vXX.X/sobjects/sObject/suggestedArticles?language=articleLanguage&subject=subject&description=description Returns a list of suggested Salesforce Knowledge articles for a case, work order, or work order line item. |
| Delete Lightning Experience Event Series |
/services/data/vXX.X/sobjects/Event/id/fromThisEventOnwards Removes one or more IsRecurrence2 events in a series. |
| Streaming Channel Push (Steaming API) |
/services/data/vXX.X/sobjects/StreamingChannel/channelId/push Gets subscriber information, and pushes notifications for streaming channels. See the Streaming API Developer Guide. |
| sObject User Password |
/services/data/vXX.X/sobjects/User/userId/password /services/data/vXX.X/sobjects/SelfServiceUser/selfServiceUserId/password Sets, resets, or gets information about a user password. |
| Data Category Groups |
/services/data/vXX.X/support/dataCategoryGroups Gets data category groups that are visible to the current user. |
| Data Category Detail |
/services/data/vXX.X/support/dataCategoryGroups/group/dataCategories/category Gets data category details and the child categories by a given category. |
| Embedded Service Configuration Describe |
/services/data/vXX.X/support/embeddedservice/configuration/serviceName Returns information corresponding to one or more service report templates in field service. |
| Field Service Flow |
/services/data/vXX.X/support/fieldservice/Flow?developerNames=flowName Returns information corresponding to a field service flow. See Field Service Flow in the Field Service Developer Guide. |
| Field Service Report Template |
/services/data/vXX.X/support/fieldservice/ServiceReportTemplate Returns information corresponding to one or more service report templates in field service. See Service Report Template in the Field Service Developer Guide. |
| Articles Details |
/services/data/vXX.X/support/knowledgeArticles/articleId /services/data/vXX.X/support/knowledgeArticles/articleUrlName Gets all online article fields, accessible to the user. |
| Tabs |
/services/data/vXX.X/tabs Returns a list of all tabs—including Lightning page tabs—available to the current user, regardless of whether the user has chosen to hide tabs via the All Tabs (+) tab customization feature. |
| Themes |
/services/data/vXX.X/theme Gets the list of icons and colors used by themes in the Salesforce application. |
| Tooling API |
/services/data/vXX.X/tooling Accesses features in the Tooling API. See the Tooling API Developer Guide. |
| UI API |
/services/data/vXX.X/ui-api Accesses features in the UI API. See the User Interface API Developer Guide. |
| Wave (Tableau CRM REST API) |
/services/data/vXX.X/wave Accesses features in the Tableau CRM REST API. See the Tableau CRM REST API Developer Guide. |