Perform a Search Query Aggregation

POST {{baseUrl}}/search/aggregate

Performs a search query aggregation and returns the aggregation result. By default, you can page a maximum of 10,000 search result records. To page past 10,000 records, you can use searchAfter paging. Refer to Paginating Search Queries for more information about how to implement searchAfter paging.

Request Params

KeyDatatypeRequiredDescription
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results.
See V3 API Standard Collection Parameters for more information.
limitnumberMax number of results to return.
See V3 API Standard Collection Parameters for more information.
countbooleanIf true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored.

Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used.

See V3 API Standard Collection Parameters for more information. |

Request Body

{"indices"=>["identities"], "aggregationType"=>"SAILPOINT", "aggregations"=>{"metric"=>{"name"=>"How Many Locations", "type"=>"UNIQUE_COUNT", "field"=>"attributes.city"}}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring