Returns all Entitlement resources.​
This endpoint returns all Entitlement resources.
Attributes to include in the response can be specified with the 'attributes' query parameter.
Attributes to exclude from the response can be specified with the 'excludedAttributes' query parameter.
The schemas related to Entitlements are:
- urn:ietf:params:scim:schemas:sailpoint:1.0:Entitlement
Query Parameters
- filter string
Allows for query filters according to RFC-7644, Section 3.4.2.2 - not all operations are supported.
- sortBy string
Allows sorting the results by a resource's attributes.
- sortOrder string
Default value:
ascending
Determines what order to sort results in.
- startIndex integer
Default value:
1
Determines the starting index of the result set.
- count integer
Default value:
1000
Specifies the number of results per page.
- attributes string
A comma-separated list of attributes to return in the response. This query parameter supersedes excludedAttributes, so providing the same attribute(s) to both will result in the attribute(s) being returned.
- excludedAttributes string
A comma-separated list of attributes to exclude from the response. Some attributes cannot be excluded.
- 200
Returned all SCIM resources for this endpoint.
- application/json
- application/scim+json
- Schema
- Example (from schema)
Schema
- totalResults integer
Number of resources returned for this endpoint.
- startIndex integer
The starting index of the resource set list. Can be specified with startIndex query parameter.
- schemas string[]
SCIM Schema used for response.
Resources undefined[]
id stringUnique identifier of the Entitlement.
descriptions object
A list of localized descriptions of the Entitlement.
locale stringThe locale associated with this Entitlement description.
value stringThe description in localized form.
displayName stringDisplayable name of the Entitlement.
type stringType of the Entitlement.
application undefined[]
The corresponding Application object of the Entitlement.
value stringThe Application associated with the Entitlement.
$ref stringThe URI of the SCIM resource representating the Entitlement application.
displayName stringThe name of the Entitlement Application. OPTIONAL and READ-ONLY.
owner undefined[]
The owner of the Entitlement.
value stringThe id of the SCIM resource representing the Entitlement Owner.
$ref stringThe URI of the SCIM resource representing the Entitlement Owner.
displayName stringThe displayName of the Entitlement Owner. OPTIONAL and READ-ONLY.
requestable booleanFlag to indicate this entitlement is requestable.
aggregated booleanFlag to indicate this entitlement has been aggregated.
attribute stringAttribute of the Entitlement.
value stringAttribute value of the Entitlement.
lastRefresh date-timeThe DateTime when the Entitlement was refreshed.
lastTargetAggregation date-timeThe date aggregation was last targeted of the Entitlement.
classifications object
Classifications of this Entitlement.
source stringThe source of the ObjectClassification.
effective booleanFlag indicating this is an effective Classification.
classification object
Classification of this object.
name stringThe name of the classification.
displayName stringThe display name of the classification.
origin stringThe origin of the Classification.
type stringThe type of the Classification.
meta object
created date-timeDateTime when the Entitlement was created.
location stringURL to the Entitlement.
lastModified date-timeDateTime of Entitlement last modification.
version stringEntitlement version.
resourceType stringResource type of the metadata subject.
schemas arrayentitleAuth stringThis is an Extended Attribute from Managed Attribute used to describe the authorization level of an Entitlement.
entDate date-timeThis is an Extended Attribute from Managed Attribute. The Entitlement DateTime.
active booleanThis is an Extended Attribute from Managed Attribute. Describes if an Entitlement is active.
rank integerThis is an Extended Attribute from Managed Attribute.
rule stringThis is an Extended Attribute from Managed Attribute. Used to specify a Rule object for the Entitlement.
reviewer object
This is an Extended Attribute from Managed Attribute. The Identity that reviewed the Entitlement.
displayName stringDisplay name of the Entitlement reviewer.
value stringid of the Entitlement reviewer.
$ref stringURI reference of the Entitlement reviewer resource.
email stringThis is an Extended Attribute from Managed Attribute. Used to specify the Entitlement owner email.
{
"totalResults": "1,",
"startIndex": 1,
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:ListResponse"
],
"Resources": [
{
"id": "7f00000180281df7818028bfb83204dc",
"descriptions": {
"locale": "en_GB",
"value": "<strong>**AP_Logins**</strong> Target Friendly Description"
},
"displayName": "AP_Logins",
"type": "Permission",
"application": [
{
"value": "7f00000180281df7818028bfac5a0367",
"$ref": "http://localhost:8080/identityiq/scim/v2/Applications/7f00000180281df7818028bfed100826",
"displayName": "Oracle_DB_oasis"
}
],
"owner": [
{
"value": "7f00000180281df7818028bfb0d103c7",
"$ref": "http://localhost:8080/identityiq/scim/v2/Users/7f00000180281df7818028bfb0d103c7",
"displayName": "Debra Wood"
}
],
"requestable": true,
"aggregated": true,
"attribute": "AP_Logins",
"value": "CN=AP_Logins,OU=Security,OU=Permissions,DC=test,DC=sailpoint,DC=com",
"lastRefresh": "2022-04-14T10:48:01.907-05:00",
"lastTargetAggregation": "2022-04-14T10:48:01.907-05:00",
"classifications": {
"source": "UI",
"effective": false,
"classification": {
"name": "ClassificationB",
"displayName": "ClassB",
"origin": "PAMSource",
"type": "Aggregation"
}
},
"meta": {
"created": "2022-04-14T10:44:54.834-05:00",
"location": "http://localhost:8080/identityiq/scim/v2/Entitlements/7f00000180281df7818028bfb83204dc",
"lastModified": "2022-04-05T15:52:30.119-05:00",
"version": "\"W\"1649951094834\"",
"resourceType": "Entitlement"
},
"schemas": [
"urn:ietf:params:scim:schemas:sailpoint:1.0:Entitlement"
],
"entitleAuth": "Low",
"entDate": "2022-04-14T10:44:54.738-05:00",
"active": false,
"rank": 3,
"rule": "APLogin-Contractors-Rule",
"reviewer": {
"displayName": "Dan Patrick",
"value": "c0b4568a4fe7458c434ee77f2fad267c",
"$ref": "http://localhost:8080/identityiq/scim/v2/Users/c0b4568a4fe7458c434ee77f2fad267c"
},
"email": "dpatrick@demoexample.com"
}
]
}
- Schema
- Example (from schema)
Schema
- totalResults integer
Number of Entitlement resources returned.
- startIndex integer
The starting index of the resource set list. Can be specified with startIndex query parameter.
- schemas string[]
SCIM Schema used for response.
Resources undefined[]
The SCIM resources returned for this endpoint.
id stringUnique identifier of the Entitlement.
descriptions object
A list of localized descriptions of the Entitlement.
locale stringThe locale associated with this Entitlement description.
value stringThe description in localized form.
displayName stringDisplayable name of the Entitlement.
type stringType of the Entitlement.
application undefined[]
The corresponding Application object of the Entitlement.
value stringThe Application associated with the Entitlement.
$ref stringThe URI of the SCIM resource representating the Entitlement application.
displayName stringThe name of the Entitlement Application. OPTIONAL and READ-ONLY.
owner undefined[]
The owner of the Entitlement.
value stringThe id of the SCIM resource representing the Entitlement Owner.
$ref stringThe URI of the SCIM resource representing the Entitlement Owner.
displayName stringThe displayName of the Entitlement Owner. OPTIONAL and READ-ONLY.
requestable booleanFlag to indicate this entitlement is requestable.
aggregated booleanFlag to indicate this entitlement has been aggregated.
attribute stringAttribute of the Entitlement.
value stringAttribute value of the Entitlement.
lastRefresh date-timeThe DateTime when the Entitlement was refreshed.
lastTargetAggregation date-timeThe date aggregation was last targeted of the Entitlement.
classifications object
Classifications of this Entitlement.
source stringThe source of the ObjectClassification.
effective booleanFlag indicating this is an effective Classification.
classification object
Classification of this object.
name stringThe name of the classification.
displayName stringThe display name of the classification.
origin stringThe origin of the Classification.
type stringThe type of the Classification.
meta object
created date-timeDateTime when the Entitlement was created.
location stringURL to the Entitlement.
lastModified date-timeDateTime of Entitlement last modification.
version stringEntitlement version.
resourceType stringResource type of the metadata subject.
schemas arrayentitleAuth stringThis is an Extended Attribute from Managed Attribute used to describe the authorization level of an Entitlement.
entDate date-timeThis is an Extended Attribute from Managed Attribute. The Entitlement DateTime.
active booleanThis is an Extended Attribute from Managed Attribute. Describes if an Entitlement is active.
rank integerThis is an Extended Attribute from Managed Attribute.
rule stringThis is an Extended Attribute from Managed Attribute. Used to specify a Rule object for the Entitlement.
reviewer object
This is an Extended Attribute from Managed Attribute. The Identity that reviewed the Entitlement.
displayName stringDisplay name of the Entitlement reviewer.
value stringid of the Entitlement reviewer.
$ref stringURI reference of the Entitlement reviewer resource.
email stringThis is an Extended Attribute from Managed Attribute. Used to specify the Entitlement owner email.
{
"totalResults": "1500,",
"startIndex": 1,
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:ListResponse"
],
"Resources": [
{
"id": "7f00000180281df7818028bfb83204dc",
"descriptions": {
"locale": "en_GB",
"value": "<strong>**AP_Logins**</strong> Target Friendly Description"
},
"displayName": "AP_Logins",
"type": "Permission",
"application": [
{
"value": "7f00000180281df7818028bfac5a0367",
"$ref": "http://localhost:8080/identityiq/scim/v2/Applications/7f00000180281df7818028bfed100826",
"displayName": "Oracle_DB_oasis"
}
],
"owner": [
{
"value": "7f00000180281df7818028bfb0d103c7",
"$ref": "http://localhost:8080/identityiq/scim/v2/Users/7f00000180281df7818028bfb0d103c7",
"displayName": "Debra Wood"
}
],
"requestable": true,
"aggregated": true,
"attribute": "AP_Logins",
"value": "CN=AP_Logins,OU=Security,OU=Permissions,DC=test,DC=sailpoint,DC=com",
"lastRefresh": "2022-04-14T10:48:01.907-05:00",
"lastTargetAggregation": "2022-04-14T10:48:01.907-05:00",
"classifications": {
"source": "UI",
"effective": false,
"classification": {
"name": "ClassificationB",
"displayName": "ClassB",
"origin": "PAMSource",
"type": "Aggregation"
}
},
"meta": {
"created": "2022-04-14T10:44:54.834-05:00",
"location": "http://localhost:8080/identityiq/scim/v2/Entitlements/7f00000180281df7818028bfb83204dc",
"lastModified": "2022-04-05T15:52:30.119-05:00",
"version": "\"W\"1649951094834\"",
"resourceType": "Entitlement"
},
"schemas": [
"urn:ietf:params:scim:schemas:sailpoint:1.0:Entitlement"
],
"entitleAuth": "Low",
"entDate": "2022-04-14T10:44:54.738-05:00",
"active": false,
"rank": 3,
"rule": "APLogin-Contractors-Rule",
"reviewer": {
"displayName": "Dan Patrick",
"value": "c0b4568a4fe7458c434ee77f2fad267c",
"$ref": "http://localhost:8080/identityiq/scim/v2/Users/c0b4568a4fe7458c434ee77f2fad267c"
},
"email": "dpatrick@demoexample.com"
}
]
}