---
schema_version: "1"
id: 4224532aeedba201e11c92540765bc7d7b2f20b3add20ca407c1bf99c21dfbf4
title: USING Listview=
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/salesforce-soql-sosl/guides/soql-sosl/sforce-api-calls-sosl-using-listview.md
canonical_url: https://developer.salesforce.com/docs/platform/salesforce-soql-sosl/guide/sforce-api-calls-sosl-using-listview.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: b81604c568eca96c862fc1433f0e522980001d6cf4c3bc854ca1391fe6b55348
products:
  - SOQL and SOSL Reference
  - Platform Developer Content
---

# USING Listview=

Optional clause used to search within a single given object’s list view. Only one list view can be specified. Only the first 2,000 records of the list view are searched, according to the sort order the user has set for the list view. The clause can be used in API version 41 or later.

## Example

The following SOSL statement searches through the _MVP Customers_ list view for the Account object for `Acme`.

```nolang
FIND {Acme} IN ALL FIELDS RETURNING Account(Id, Name USING ListView=MVPCustomers)
```

## Example

The following SOSL statement searches through the recently viewed list view for the Account object for `Acme`.

```nolang
FIND {Acme} IN ALL FIELDS RETURNING Account(Name USING LISTVIEW = Recent ORDER BY Name ASC NULLS FIRST, Id ASC NULLS FIRST LIMIT 51)
```

## Supported APIs

The clause in SOSL is supported in SOAP API, REST API, and Apex.