Skip to content

Return runtime entitlements matching the supplied filters.

GET
/api/workspace/entitlement-operations/entitlements
curl --request GET \
--url 'https://example.com/api/workspace/entitlement-operations/entitlements?ConditionFamily=0&TermKind=0&TermUnit=0&Status=0'
  • None
ModelId
string

Optional entitlement model filter.

PlanId
string

Optional entitlement plan filter.

PlanFamilyIds
Array<string>

Optional plan family ids that at least one current linked plan family must match.

ConditionFamily
integer format: int32
Allowed values: 0 1 2 3

Optional active condition family on the current linked plan.

TermKind
integer format: int32
Allowed values: 0 1 2 3

Optional derived active term shape on the current linked plan.

TermValue
integer format: int32

Optional duration/window value paired with TermKind.

TermUnit
integer format: int32
Allowed values: 0 1 2

Optional duration/window unit paired with TermKind.

RenewalPolicyId
string

Optional renewal policy currently assigned to the linked plan.

OwnerPartyRoleId
string

Optional owner party role filter.

OwnerEntityInstanceId
string

Optional owner party instance filter.

Status
integer format: int32
Allowed values: 0 1 2 3 4 5 6

Optional lifecycle status filter.

StartsFromUtc
string format: date-time

Optional inclusive start boundary.

StartsToUtc
string format: date-time

Optional inclusive start boundary end.

EndsFromUtc
string format: date-time

Optional inclusive end boundary.

EndsToUtc
string format: date-time

Optional inclusive end boundary end.

Search
string

Optional search text matched against plan/model/party display names.

Page
integer format: int32

One-based page number.

PageSize
integer format: int32

Requested page size.

access_token
string

Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.

OK

Media typeapplication/json
object
Data

Paginated runtime entitlement list response.

object
Items
Array<object>
nullable

Runtime entitlement summary row.

object
Id
string
nullable
EntitlementNumber
integer format: int64
EntitlementModelId
string
nullable
EntitlementModelDisplayName
string
nullable
ModelType
integer format: int32
Allowed values: 0 1 2 3
EntitlementPlanId
string
nullable
EntitlementPlanDisplayName
string
nullable
Owner

Compact customer-owned entity instance reference.

object
EntityDefinitionId
string
nullable
EntityDisplayName
string
nullable
EntityInstanceId
string
nullable
DisplayName
string
nullable
Status
integer format: int32
Allowed values: 0 1 2 3 4 5 6
EffectiveState
integer format: int32
Allowed values: 0 1 2 3 4 5 6 8
StartsAtUtc
string format: date-time
EndsAtUtc
string format: date-time
nullable
GraceUntilUtc
string format: date-time
nullable
IssuedAtUtc
string format: date-time
IssuedByUserId
string
nullable
ResourceCount
integer format: int32
BeneficiaryCount
integer format: int32
PlanFamilies
Array<object>
nullable

Plan family reference shown on runtime entitlement rows.

object
Id
string
nullable
Key
string
nullable
DisplayName
string
nullable
Description
string
nullable
SortOrder
integer format: int32
IsActive
boolean
ObjectInvariant

Resource-neutral current invariant state and complete object-operation decision set.

object
Resource
object
ModuleKey
string
nullable
ResourceKind
string
nullable
ContextResourceId
string
nullable
ResourceObjectId
string
nullable
BusinessInvariants

Current safe state of every applicable enabled Business Invariant.

Array<object>
nullable

Current safe state of one Business Invariant target for one resource.

object
InvariantKey

Stable invariant key.

string
nullable
TargetKey

Stable target key within the invariant.

string
nullable
IsActive

Whether the invariant is active for the current resource state.

boolean
SafeMessage

Localized safe active-state message, or null when inactive.

string
nullable
Operations

Explicit decision for every applicable and discoverable Object Operation Catalog entry on the current surface.

object
key
additional properties

Composed current decision for one applicable object operation.

object
OperationKey

Stable Object Operation Catalog key.

string
nullable
IsAllowed

Whether all independent authorities allow the operation.

boolean
Denials

Deterministically ordered safe denial details.

Array<object>
nullable

One safe denial contributing to a composed object-operation decision.

object
Source

Identifies the independent authority that denied an object operation.

integer format: int32
Allowed values: 0 1 2 3
SourceKey

Stable source identity, such as an invariant key or domain policy key.

string
nullable
ReasonCode

Stable machine-readable reason code.

string
nullable
SafeMessage

Non-empty localized safe message.

string
nullable
RowVersion
string format: uuid
TotalCount
integer format: int32
Page
integer format: int32
PageSize
integer format: int32
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"Items": [
{
"ModelType": 0,
"Status": 0,
"EffectiveState": 0,
"ObjectInvariant": {
"Operations": {
"additionalProperty": {
"Denials": [
{
"Source": 0
}
]
}
}
}
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Forbidden

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}