List Identities
GEThttps://sailpoint.api.identitynow.com/beta/identities
This API returns a list of identities.
Request
Query Parameters
Filter results using the standard syntax described in V3 API Standard Collection Parameters
Filtering is supported for the following fields and operators:
id: eq, in
name: eq, sw
alias: eq, sw
firstname: eq, sw
lastname: eq, sw
email: eq, sw
cloudStatus: eq
processingState: eq
correlated: eq
protected: eq
Sort results using the standard syntax described in V3 API Standard Collection Parameters
Sorting is supported for the following fields: name, alias, cloudStatus
Possible values: [CORRELATED_ONLY
, NONE
]
Adds additional filter to filters query parameter.
CORRELATED_ONLY adds correlated=true and returns only identities that are correlated.
NONE does not add any and returns all identities that satisfy filters query parameter.
CORRELATED_ONLY
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.
false
Possible values: <= 250
Max number of results to return. See V3 API Standard Collection Parameters for more information.
250
Offset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.
0
Responses
- 200
- 400
- 401
- 403
- 429
- 500
List of identities.
- application/json
- Schema
- Example (auto)
Schema
- Array [
- ]
System-generated unique ID of the identity
01f04e428c484542a241dc89c303b178
The identity's name is equivalent to its Display Name attribute.
Walter White
Creation date of the identity
2023-01-03T21:16:22.432Z
Last modification date of the identity
2023-01-03T21:16:22.432Z
The identity's alternate unique identifier is equivalent to its Account Name on the authoritative source account schema.
walter.white
The email address of the identity
walter.white@example.com
The processing state of the identity
Possible values: [ERROR
, OK
, null
]
ERROR
The identity's status in the system
Possible values: [UNREGISTERED
, REGISTERED
, PENDING
, WARNING
, DISABLED
, ACTIVE
, DEACTIVATED
, TERMINATED
, ERROR
, LOCKED
]
LOCKED
managerRef objectnullable
Whether this identity is a manager of another identity
false
true
The last time the identity was refreshed by the system
2020-11-22T15:42:31.123Z
A map with the identity attributes for the identity
{"uid":"86754","firstname":"Walter","cloudStatus":"UNREGISTERED","displayName":"Walter White","identificationNumber":"86754","lastSyncDate":1470348809380,"email":"walter.white@example.com","lastname":"White"}
lifecycleState objectnullable
[
{
"id": "01f04e428c484542a241dc89c303b178",
"name": "Walter White",
"created": "2023-01-03T21:16:22.432Z",
"modified": "2023-01-03T21:16:22.432Z",
"alias": "walter.white",
"emailAddress": "walter.white@example.com",
"processingState": "ERROR",
"identityStatus": "LOCKED",
"managerRef": {
"type": "IDENTITY",
"id": "2c4180a46faadee4016fb4e018c20626",
"name": "Robert Robinson"
},
"isManager": true,
"lastRefresh": "2020-11-22T15:42:31.123Z",
"attributes": {
"uid": "86754",
"firstname": "Walter",
"cloudStatus": "UNREGISTERED",
"displayName": "Walter White",
"identificationNumber": "86754",
"lastSyncDate": 1470348809380,
"email": "walter.white@example.com",
"lastname": "White"
},
"lifecycleState": {
"stateName": "active",
"manuallyUpdated": true
}
}
]
Client Error - Returned if the request body is invalid.
- application/json
- Schema
- Example (auto)
Schema
Fine-grained error code providing more detail of the error.
400.1 Bad Request Content
Unique tracking id for the error.
e7eab60924f64aa284175b9fa3309599
messages object[]
causes object[]
{
"detailCode": "400.1 Bad Request Content",
"trackingId": "e7eab60924f64aa284175b9fa3309599",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
],
"causes": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
]
}
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
- application/json
- Schema
- Example (auto)
Schema
A message describing the error
JWT validation failed: JWT is expired
{
"error": "JWT validation failed: JWT is expired"
}
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
- application/json
- Schema
- Example (auto)
- 403
Schema
Fine-grained error code providing more detail of the error.
400.1 Bad Request Content
Unique tracking id for the error.
e7eab60924f64aa284175b9fa3309599
messages object[]
causes object[]
{
"detailCode": "400.1 Bad Request Content",
"trackingId": "e7eab60924f64aa284175b9fa3309599",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
],
"causes": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
]
}
An example of a 403 response object
{
"detailCode": "403 Forbidden",
"trackingId": "b21b1f7ce4da4d639f2c62a57171b427",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The server understood the request but refuses to authorize it."
}
]
}
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.
- application/json
- Schema
- Example (auto)
Schema
A message describing the error
Rate Limit Exceeded
{
"message": " Rate Limit Exceeded "
}
Internal Server Error - Returned if there is an unexpected error.
- application/json
- Schema
- Example (auto)
- 500
Schema
Fine-grained error code providing more detail of the error.
400.1 Bad Request Content
Unique tracking id for the error.
e7eab60924f64aa284175b9fa3309599
messages object[]
causes object[]
{
"detailCode": "400.1 Bad Request Content",
"trackingId": "e7eab60924f64aa284175b9fa3309599",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
],
"causes": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "The request was syntactically correct but its content is semantically invalid."
}
]
}
An example of a 500 response object
{
"detailCode": "500.0 Internal Fault",
"trackingId": "b21b1f7ce4da4d639f2c62a57171b427",
"messages": [
{
"locale": "en-US",
"localeOrigin": "DEFAULT",
"text": "An internal fault occurred."
}
]
}
Authorization: oauth2
type: Personal Access Tokenscopes: idn:identity:read, idn:identity:manage
- go
- powershellSailPoint SDK
- pythonSailPoint SDK
- csharp
- curl
- dart
- http
- java
- javascript
- kotlin
- c
- nodejs
- objective-c
- ocaml
- php
- r
- ruby
- rust
- shell
- swift
- NATIVE