get:
  operationId: getIdentityOutliers
  tags:
    - IAI Outliers
  summary: IAI Get Identity Outliers
  description: >-
    This API receives a list of outliers, containing data such as: identityId, outlier type, detection dates, identity attributes, if identity is ignore, and certification information

    Requires authorization scope of 'iai:outliers-management:read'
  parameters:
    - $ref: '../../v3/parameters/limit.yaml'
    - $ref: '../../v3/parameters/offset.yaml'
    - $ref: '../../v3/parameters/count.yaml'
    - name: type
      in: query
      description: Type of the identity outliers snapshot to filter on
      required: false
      schema:
        type: string
        enum:
          - LOW_SIMILARITY
          - STRUCTURAL
        example: LOW_SIMILARITY   
    - in: query
      name: filters
      required: false
      schema:
        type: string
        example: attributes.displayName sw "John" and certStatus eq "false"  
      description: >-
        Filter results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#filtering-results)


        Filtering is supported for the following Entitlement fields and operators:

        **attributes**: *eq, sw, co, in*


        **firstDetectionDate**: *ge, le*


        **certStatus**: *eq*


        **ignored**: *eq*


        **score**: *ge, le*
    - in: query
      name: sorters
      required: false
      schema:
        type: string
        format: comma-separated
        example: attributes.displayName,firstDetectionDate,-score  
      description: >-
        Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results)

        Sorting is supported for the following fields: **firstDetectionDate, attributes, score**
  responses:
    '200':
      description: Succeeded. Returns list of objects. Each object contains information about outliers
      headers:
        X-Total-Count:
          description: The total result count.
          schema:
            type: integer
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '../schemas/Outlier.yaml'
    '400':
      $ref: '../../v3/responses/400.yaml'
    '401':
      $ref: '../../v3/responses/401.yaml'
    '403':
      $ref: '../../v3/responses/403.yaml'
    '429':
      $ref: '../../v3/responses/429.yaml'
    '500':
      $ref: '../../v3/responses/500.yaml'
