---
schema_version: "1"
id: 81be429ff500c61adb06e505a35d1e79ce4a88d180ab8a03daacb01ed8d79617
title: Get Relevant Items
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/api-rest/guides/do-me/dome-get-relevant-items.md
canonical_url: https://developer.salesforce.com/docs/platform/api-rest/guide/dome-get-relevant-items.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: efd4ffb46131c36b95899f59a989e66bb221e703a4d0cf2e9e94c03217cf826f
products:
  - REST API Developer Guide
  - Platform Developer Content
---

# Get Relevant Items

Use the Relevant Items resource to retrieve a list of relevant items.

## Example usage for getting a list of the current user’s most relevant records

```nolang
curl https://MyDomainName.my.salesforce.com/services/data/v68.0/sobjects/relevantItems -H "Authorization: Bearer token"
```

**Example request body**

None required

**Example response body**

```nolang
[ {
    "apiName" : "Contact",
    "key" : "003",
    "label" : "Contacts",
    "lastUpdatedId" : "135866748",
    "recordIds" : [ "003xx000004TxBA" ]
}, {   "apiName" : "Account",
    "key" : "001",
    "label" : "Accounts",
    "lastUpdatedId" : "193640553",
    "recordIds" : [ "001xx000003DWsT" ]
}, {
    "apiName" : "User",
    "key" : "005",
    "label" : "Users",
    "lastUpdatedId" : "-199920321",
    "recordIds" : [ "005xx000001Svqw", "005xx000001SvwK", "005xx000001SvwA" ]
}, {  "apiName" : "Case",
    "key" : "069",
    "label" : "Cases",
    "lastUpdatedId" : "1033471693",
    "recordIds" : [ "069xx0000000006", "069xx0000000001", "069xx0000000002" ]
} ]
```

## Example usage for filtering the response to certain objects

```nolang
curl https://MyDomainName.my.salesforce.com/services/data/v68.0/sobjects/relevantItems?sobjects=Account,User -H "Authorization: Bearer token"
```

**Example request body**

None required

**Example response body**

```nolang
[ {
    "apiName" : "Account",
    "key" : "001",
    "label" : "Accounts",
    "lastUpdatedId" : "193640553",
    "recordIds" : [ "001xx000003DWsT" ]
}, {
  "apiName" : "User",
    "key" : "005",
    "label" : "Users",
    "lastUpdatedId" : "102959935",
    "recordIds" : [ "005xx000001Svqw", "005xx000001SvwK", "005xx000001SvwA" ]
} ]
```

## Example usage for comparing the user’s current list of relevant records to a previous version

```nolang
curl https://MyDomainName.my.salesforce.com/services/data/v68.0/sobjects/relevantItems?lastUpdatedId=102959935 -H "Authorization: Bearer token"
```

**Example request body**

None required

**Example response header**

```nolang
lastUpdatedId: 102959935
newResultSetSinceLastQuery: true
```

**Example response body**

```nolang
[ {
    "apiName" : "User",
    "key" : "003",
    "label" : "Users",
    "lastUpdatedId" : "102959935",
    "recordIds" : [ "003xx000004TxBA" ]
}, {
    "apiName" : "Account",
    "key" : "001",
    "label" : "Accounts",
    "lastUpdatedId" : "193640553",
    "recordIds" : [ "001xx000003DWsT" ]
}, {
    "apiName" : "Case",
    "key" : "005",
    "label" : "Cases",
  "lastUpdatedId" : "1740766611",
    "recordIds" : [ "005xx000001Svqw", "005xx000001SvwA" ]
} ]
```

## Example usage for comparing the user’s current list of relevant records to a previous version for a particular object

```nolang
curl https://MyDomainName.my.salesforce.com/services/data/v68.0/sobjects/relevantItems?mode=MRU&sobjects=Account,Contact&Account.lastUpdatedId=102959935 -H "Authorization: Bearer token"
```

**Example request body**

None required

**Example response body**

```nolang
[ {
    "apiName" : "Account",
    "key" : "001",
    "label" : "Accounts",
    "lastUpdatedId" : "193640553",
    "recordIds" : [ "001xx000003DWsT" ]
} ]
```

**See Also**  


-   [sObject Relevant Items](https://developer.salesforce.com/docs/platform/api-rest/resources/resources-relevant-items.md)