--- id: search-aggregate sidebar_label: Perform a Search Query Aggregation hide_title: true hide_table_of_contents: true api: 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 sidebar_class_name: "post api-method" info_path: docs/api/v3/identitynow-v-3-api custom_edit_url: "https://github.com/sailpoint-oss/developer.sailpoint.com/issues/new?assignees=&labels=&template=bug-report.md&title=%5BBug%5D+Your+Bug+Report+Here Requesting changes to 'Perform a Search Query Aggregation' (search-aggregate)" --- import ApiTabs from "@theme/ApiTabs"; import DiscriminatorTabs from "@theme/DiscriminatorTabs"; import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes"; import MimeTabs from "@theme/MimeTabs"; import ParamsItem from "@theme/ParamsItem"; import ResponseSamples from "@theme/ResponseSamples"; import SchemaItem from "@theme/SchemaItem"; import SchemaTabs from "@theme/SchemaTabs"; import TabItem from "@theme/TabItem";

Perform a Search Query Aggregation

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](https://developer.sailpoint.com/idn/api/standard-collection-parameters#paginating-search-queries) for more information about how to implement searchAfter paging. ## Request

Query Parameters

Body

required
    query object
    Query parameters used to construct an Elasticsearch query object.
    innerHit object
    The innerHit query object returns a flattened list of results for the specified nested type.
    textQuery object
    Query parameters used to construct an Elasticsearch text query object.
    typeAheadQuery object
    Query parameters used to construct an Elasticsearch type ahead query object. The typeAheadQuery performs a search for top values beginning with the typed values. For example, typing "Jo" results in top hits matching "Jo." Typing "Job" results in top hits matching "Job."
    = 1` and `<= 1000`"} schema={{"description":"The number of suffixes the last term will be expanded into.\nInfluences the performance of the query and the number results returned.\nValid values: 1 to 1000.","type":"integer","format":"int32","minimum":1,"maximum":1000,"default":10,"example":10}}>= 1`"} schema={{"description":"The max amount of records the search will return.","type":"integer","format":"int32","minimum":1,"default":100,"example":100}}>
    queryResultFilter object
    Allows the query results to be filtered by specifying a list of fields to include and/or exclude from the result documents.
    aggregations object
    nested object
    The nested aggregation object.
    metric object
    The calculation done on the results of the query
    filter object
    An additional filter to constrain the results of the search query.
    bucket object
    The bucket to group the results of the aggregation query by.
    subAggregation object
    Aggregation to be performed on the result of the parent bucket aggregation.
    nested object
    The nested aggregation object.
    metric object
    The calculation done on the results of the query
    filter object
    An additional filter to constrain the results of the search query.
    bucket object
    The bucket to group the results of the aggregation query by.
    subAggregation object
    Aggregation to be performed on the result of the parent bucket aggregation.
    nested object
    The nested aggregation object.
    metric object
    The calculation done on the results of the query
    filter object
    An additional filter to constrain the results of the search query.
    bucket object
    The bucket to group the results of the aggregation query by.
    filters object
    The filters to be applied for each filtered field name.
    property name* Filter
    range object
    The range of values to be filtered.
    lower object
    The lower bound of the range.
    upper object
    The upper bound of the range.
Aggregation results.
Response Headers
  • X-Total-Count integer
    Example: 5 The total result count (returned only if the *count* parameter is specified as *true*).
Schema
    hits object[]
    The results of the aggregation search query.
  • Array [
  • oneOf
    owner object
    Owner's identity.
    source object
    Access profile's source.
    entitlements object[]
    Entitlements the access profile has access to.
  • Array [
  • ]
  • requester object
    recipient object
    approvals object[]
    Approvals performed on an item during activity.
  • Array [
  • comments object[]
  • Array [
  • ]
  • owner object
  • ]
  • originalRequests object[]
    Original actions that triggered all individual source actions related to the account action.
  • Array [
  • attributeRequests object[]
    Attribute changes requested for account.
  • Array [
  • ]
  • source object
    Account's source.
  • ]
  • expansionItems object[]
    Controls that translated the attribute requests into actual provisioning actions on the source.
  • Array [
  • attributeRequests object[]
  • Array [
  • ]
  • source object
  • ]
  • accountRequests object[]
    Account data for each individual source action triggered by the original requests.
  • Array [
  • attributeRequests object[]
  • Array [
  • ]
  • provisioningTarget object
    result object
    source object
  • ]
  • source object
    Entitlement's source.
    segments object[]
    Segments with the role.
  • Array [
  • ]
  • attributes object
    Attributes involved in the event.
    manager objectnullable
    Identity's manager.
    identityProfile object
    Identity's identity profile.
    source object
    Identity's source.
    attributes object
    Map or dictionary of key/value pairs.
    processingDetails objectnullable
    Identity's processing details.
    "}}>"}}>
    accounts object[]
    List of accounts associated with the identity.
  • Array [
  • source object
    entitlementAttributes objectnullable
    Map or dictionary of key/value pairs.
  • ]
  • apps object[]
    List of applications the identity has access to.
  • Array [
  • source object
    account object
  • ]
  • access object[]
    List of access items assigned to the identity.
  • Array [
  • oneOf
    source object
    owner object
    source object
    owner object
  • ]
  • owns object[]
    Access items the identity owns.
  • Array [
  • sources object[]
  • Array [
  • ]
  • entitlements object[]
  • Array [
  • ]
  • accessProfiles object[]
  • Array [
  • ]
  • roles object[]
  • Array [
  • ]
  • apps object[]
  • Array [
  • ]
  • governanceGroups object[]
  • Array [
  • ]
  • ]
  • owner object
    Owner's identity.
    accessProfiles object[]
    Access profiles included with the role.
  • Array [
  • ]
  • segments object[]
    Segments with the role.
  • Array [
  • ]
  • entitlements object[]
    Entitlements included with the role.
  • Array [
  • ]
  • ]
Schema
    string
Client Error - Returned if the request body is invalid.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
Schema
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]

An example of a 403 response object

Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.
Schema
Internal Server Error - Returned if there is an unexpected error.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]

An example of a 500 response object