# Clarity - Search records action
The Search records action searches for records in your Clarity instance based on specified criteria.
# Input
Input field | Description |
---|---|
Object | Select the type of record to search. |
Fields to retrieve | Select specific fields to return in the results. ID and timestamp fields are always included. |
Limit | Specify the maximum number of records to return. |
Offset | Enter the starting position for record retrieval to enable pagination. |
Sort | Define the sort order using field names. For example, name , lastUpdatedDate desc . Default is ascending. |
Filter criteria | Enter filter expressions using Clarity query syntax. Each expression must be in parentheses. Date format is "YYYY-MM-DD" . Examples: (transactionDate >= "2024-01-01") or (status = "ACTIVE") . |
Additional fields may load based on the object you select.
# Output
Output field | Description |
---|---|
Total count | The total number of records matching the search criteria. |
Page size | The maximum number of records per page. |
Records returned | The actual number of records returned in this response. |
Next page URL | URL to retrieve the next page of results. |
Previous page URL | URL to retrieve the previous page of results. |
Self URL | URL of the current result set. |
Results | Array containing the matching records. |
Additional fields in the Results array depend on the object type selected and the fields specified in the input.
Last updated: 10/7/2025, 3:17:27 PM