Skip to main content

List Identity Profiles

GET 

https://sailpoint.api.identitynow.com/v2024/identity-profiles

Get a list of identity profiles, based on the specified query parameters.

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
    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
    filters string

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

    Filtering is supported for the following fields and operators:

    id: eq, ne, ge, gt, in, le, sw

    name: eq, ne, ge, gt, in, le, sw

    priority: eq, ne

    Example: id eq "ef38f94347e94562b5bb8424a56397d8"
    sorters comma-separated

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

    Sorting is supported for the following fields: id, name, priority, created, modified, owner.id, owner.name

    Example: id,name

Responses

List of identity profiles.

Schema
  • Array [
  • idstring

    System-generated unique ID of the Object

    Example: id12345
    namestringnullablerequired

    Name of the Object

    Example: aName
    createddate-time

    Creation date of the Object

    Example: 2015-05-28T14:07:17Z
    modifieddate-time

    Last modification date of the Object

    Example: 2015-05-28T14:07:17Z
    descriptionstringnullable

    Identity profile's description.

    Example: My custom flat file profile
    owner objectnullable

    Identity profile's owner.

    typestring

    Owner's object type.

    Possible values: [IDENTITY]

    Example: IDENTITY
    idstring

    Owner's ID.

    Example: 2c9180835d191a86015d28455b4b232a
    namestring

    Owner's name.

    Example: William Wilson
    priorityint64

    Identity profile's priority.

    Example: 10
    authoritativeSource objectrequired
    typestring

    Authoritative source's object type.

    Possible values: [SOURCE]

    Example: SOURCE
    idstring

    Authoritative source's ID.

    Example: 2c9180835d191a86015d28455b4b232a
    namestring

    Authoritative source's name.

    Example: HR Active Directory
    identityRefreshRequiredboolean

    Set this value to 'True' if an identity refresh is necessary. You would typically want to trigger an identity refresh when a change has been made on the source.

    Default value: false
    Example: true
    identityCountint32

    Number of identities belonging to the identity profile.

    Example: 8
    identityAttributeConfig object

    Defines all the identity attribute mapping configurations. This defines how to generate or collect data for each identity attributes in identity refresh process.

    enabledboolean

    Backend will only promote values if the profile/mapping is enabled.

    Default value: false
    Example: true
    attributeTransforms object[]
  • Array [
  • identityAttributeNamestring

    Identity attribute's name.

    Example: email
    transformDefinition object
    typestring

    Transform definition type.

    Example: accountAttribute
    attributes object

    Arbitrary key-value pairs to store any metadata for the object

    property name*any

    Arbitrary key-value pairs to store any metadata for the object

    Example: {"attributeName":"e-mail","sourceName":"MySource","sourceId":"2c9180877a826e68017a8c0b03da1a53"}
  • ]
  • identityExceptionReportReference objectnullable
    taskResultIduuid

    Task result ID.

    Example: 2b838de9-db9b-abcf-e646-d4f274ad4238
    reportNamestring

    Report name.

    Example: My annual report
    hasTimeBasedAttrboolean

    Indicates the value of requiresPeriodicRefresh attribute for the identity profile.

    Default value: false
    Example: true
  • ]

Authorization: oauth2

type: Personal Access Token
scopes: idn:identity-profile:read
user levels: ORG_ADMIN

type: Client Credentials
scopes: idn:identity-profile:read
package main

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

func main() {

url := "https://sailpoint.api.identitynow.com/v2024/identity-profiles"
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/v2024
Auth
Parameters
— query
— query
— query
— query
— query
ResponseClear

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