--- schema_version: "1" id: 220abb4be79d2863aa312e47b549b3ff346e7aa531a8d5ba14dd537fa51c8834 title: Lenses List Resource collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/bi_dev_guide_rest/bi_resources_lenses.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses.htm source_site: developer.salesforce.com content_type: documentation content_hash: 6c11935a2283ac45618a1cd553fe755a107ef9f8307923950d8cdd67a8d53f41 description: Returns a list of Analytics lenses or creates a lens. --- # Lenses List Resource Returns a list of Analytics lenses or creates a lens. ## Resource URL /wave/lenses ## Formats JSON ## Available Version 36.0 ## Available in Postman To view and test a working example of this resource, see [getLensCollection](https://www.postman.com/salesforce-developers/workspace/salesforce-developers/request/12721794-e5608103-f2d8-44dd-b3fb-c60195df2ec6?action=share&source=copy-link&creator=26106753 "HTML (New Window)") in Postman. For information about how to authenticate your org with Postman, see the [CRM Analytics Rest API Quick Start](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/crma_rest_api_quick_start.htm "Connect to a Salesforce Trailhead org and authenticate. Then make a request to the CRM Analytics REST API in Postman, and look at the response."). ## Available Components - Apex — [Wave.Lenses.getLenses()](https://developer.salesforce.com/docs/atlas.en-us.264.0.bi_dev_guide_sdk.meta/bi_dev_guide_sdk/bi_sdk_apex_query.htm) - Aura — [ listLenses()](https://developer.salesforce.com/docs/atlas.en-us.264.0.bi_dev_guide_sdk.meta/bi_dev_guide_sdk/bi_sdk_asset.htm) ## HTTP Methods GET POST ## GET Request Parameters

Parameter Name	Type	Description	Required or Optional	Available Version
`folderId`	ID	Filters the results to include only the contents of a specific folder. The id can be the requesting user’s ID for items in the user’s private folder.	Optional	36.0
`page`	String	A generated token that indicates the view of the lenses to be returned.	Optional	36.0
`pageSize`	Integer	The number of items to be returned in a single page. Minimum is 1, maximum is 200, and default is 25.	Optional	36.0
`q`	String	Search terms. Individual terms are separated by spaces. A wildcard is automatically appended to the last token in the query string. If the user’s search query contains quotation marks or wildcards, those symbols are automatically removed from the query string in the URI along with any other special characters.	Optional	36.0
`scope`	ConnectWaveScopeTypeEnum	The type of scope to be applied to the returned collection. Valid values are: `CreatedByMe` `Mru` (Most Recently Used) `SharedWithMe`	Optional	38.0
`sort`	ConnectWaveSortOrderTypeEnum	The type of sort order to be applied to the returned collection. Valid values are: `App` `CreatedBy` `CreatedDate` `LastModified` `LastModifiedBy` `Mru` (Most Recently Used, last viewed date) `Name` `Type`	Optional	38.0

## GET Response Body [Lens Collection](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_lens_collection.htm "A collection of Analytics lenses.") ## POST Response Body [Lens](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_responses_lens.htm "Am Analytics lenses.")