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
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
}
]
},
"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"
}