Skip to main content

Get identity outlier's contibuting features

GET 

https://sailpoint.api.identitynow.com/v2025/outliers/:outlierId/contributing-features

experimental

This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint.

This API returns a list of contributing feature objects for a single outlier.

The object contains: feature name, feature value type, value, importance, display name (translated text or message key), description (translated text or message key), translation messages object.

Request

Path Parameters

    outlierId stringrequired

    The outlier id

    Example: 2c918085842e69ae018432d22ccb212f

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
    count boolean

    If 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.

    Default value: false
    Example: true
    include-translation-messages string

    Whether or not to include translation messages object in returned response

    sorters comma-separated

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

    Sorting is supported for the following fields: importance

    Example: importance

Header Parameters

    X-SailPoint-Experimental stringrequired

    Use this header to enable this experimental API.

    Default value: true
    Example: true

Responses

Succeeded. Returns list of objects. Each object contains a feature and metadata about that feature.

Response Headers
    X-Total-Count

    The total result count.

    accept-language

    The locale to use for translations for displayName and description text

Schema
  • Array [
  • idstring

    Contributing feature id

    Example: 66e38828-5017-47af-92ff-9844871352c5
    namestring

    The name of the feature

    Example: entitlement_count
    valueType object

    The data type of the value field

    namestring

    The data type of the value field

    Possible values: [INTEGER, FLOAT]

    Example: INTEGER
    ordinalint32

    The position of the value type

    Possible values: >= 0 and <= 1

    Example: 0
    valuefloat

    The feature value

    Possible values: >= 0

    Example: 1
    importancefloat

    The importance of the feature. This can also be a negative value

    Example: -0.15
    displayNamestring

    The (translated if header is passed) displayName for the feature

    Example: Number of entitlements
    descriptionstring

    The (translated if header is passed) description for the feature

    Example: The total number of entitlements belonging to an identity
    translationMessages objectnullable
    displayName object
    keystring

    The key of the translation message

    Example: recommender-api.V2_WEIGHT_FEATURE_PRODUCT_INTERPRETATION_HIGH
    valuesstring[]

    The values corresponding to the translation messages

    Example: ["75","department"]
    description object
    keystring

    The key of the translation message

    Example: recommender-api.V2_WEIGHT_FEATURE_PRODUCT_INTERPRETATION_HIGH
    valuesstring[]

    The values corresponding to the translation messages

    Example: ["75","department"]
  • ]

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/v2025/outliers/:outlierId/contributing-features"
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/v2025
Auth
Parameters
— pathrequired
— headerrequired
— query
— query
— query
— query
— query
ResponseClear

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