Skip to main content

IAI Identity Outliers Summary

GET 

https://sailpoint.api.identitynow.com/beta/outlier-summaries

This API returns a summary containing the number of identities that customer has, the number of outliers, and the type of outlier.

Request

Query Parameters

    limit int32

    Possible values: <= 250

    Max number of results to return. See V3 API Standard Collection Parameters for more information.

    Default value: 250
    Example: 250
    offset int32

    Offset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.

    Default value: 0
    Example: 0
    type string

    Possible values: [LOW_SIMILARITY, STRUCTURAL]

    Type of the identity outliers snapshot to filter on

    Example: LOW_SIMILARITY
    filters string

    Filter results using the standard syntax described in V3 API Standard Collection Parameters

    Filtering is supported for the following fields and operators:

    snapshotDate: ge, le

    Example: snapshotDate ge "2022-02-07T20:13:29.356648026Z"
    sorters comma-separated

    Sort results using the standard syntax described in V3 API Standard Collection Parameters

    Sorting is supported for the following fields: snapshotDate

    Example: snapshotDate

Responses

Succeeded. Returns list of objects. Each object is a summary to give high level statistics/counts of outliers.

Response Headers
    X-Total-Count

    The total result count.

Schema
  • Array [
  • typestring

    The type of outlier summary

    Possible values: [LOW_SIMILARITY, STRUCTURAL]

    Example: LOW_SIMILARITY
    snapshotDatedate-time

    The date the bulk outlier detection ran/snapshot was created

    Example: 2021-05-01T18:40:35.772Z
    totalOutliersinteger

    Total number of outliers for the customer making the request

    Example: 50
    totalIdentitiesinteger

    Total number of identities for the customer making the request

    Example: 5000
    totalIgnoredinteger
    Default value: 0
    Example: 0
  • ]

Authorization: oauth2

type: Personal Access Token
scopes: iai:outliers:read, iai:outliers:manage
user levels: ORG_ADMIN, REPORT_ADMIN

type: Client Credentials
scopes: iai:outliers:read, iai:outliers:manage
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://sailpoint.api.identitynow.com/beta/outlier-summaries"
method := "GET"

client := &http.Client {
}
req, err := http.NewRequest(method, url, nil)

if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Accept", "application/json")
req.Header.Add("Authorization", "Bearer <TOKEN>")

res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()

body, err := io.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
Request Collapse all
Base URL
https://sailpoint.api.identitynow.com/beta
Auth
Parameters
— query
— query
— query
— query
— query
ResponseClear

Click the Send API Request button above and see the response here!