# 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

On this page