Skip to content

Return entitlement ledger rows matching the supplied filters.

GET
/api/workspace/entitlement-operations/ledger
curl --request GET \
--url 'https://example.com/api/workspace/entitlement-operations/ledger?Operation=0&EntitlementStatus=0&SourceType=0'
  • None
ModelId
string

Optional entitlement model filter.

PlanId
string

Optional entitlement plan filter.

EntitlementId
string

Optional entitlement id filter.

EntitlementNumber
integer format: int64

Optional human-readable entitlement number filter.

PartyEntityInstanceId
string

Optional owner party instance filter.

ResourceEntityInstanceId
string

Optional resource instance filter.

Operation
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8

Optional ledger movement type.

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

Optional current entitlement status filter.

SourceType
integer format: int32
Allowed values: 0 1 2 3 4

Optional source type filter.

RenewalOperationId
string

Optional renewal workflow id filter.

OccurredFromUtc
string format: date-time

Optional inclusive occurrence start.

OccurredToUtc
string format: date-time

Optional inclusive occurrence end.

Search
string

Optional search across entitlement number, ids, plan/model names, owner display, reason, source, and correlation.

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 ledger response for entitlement lifecycle, renewal, and quantity history.

object
Items

Ledger rows in the requested page.

Array<object>
nullable

Compact ledger row for operational lists, detail drawers, and workflow references.

object
Id
string
nullable
EntitlementId
string
nullable
EntitlementNumber
integer format: int64
EntitlementModelId
string
nullable
EntitlementModelDisplayName
string
nullable
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
Operation
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8
EntitlementStatus
integer format: int32
Allowed values: 0 1 2 3 4 5 6
EntitlementEffectiveState
integer format: int32
Allowed values: 0 1 2 3 4 5 6 8
Quantity
number format: double
BalanceAfter
number format: double
nullable
EntitlementLimitId
string
nullable
ReversesLedgerEntryId
string
nullable
RenewalOperationId
string
nullable
ReasonCode
string
nullable
ReasonText
string
nullable
SourceType
integer format: int32
Allowed values: 0 1 2 3 4
SourceData
string
nullable
ActorUserId
string
nullable
Actor

Resolved user or actor display reference for entitlement ledger audit rows.

object
Id

User identifier or stable external actor identifier stored on the ledger row.

string
nullable
DisplayName

Display name resolved from the workspace security cache when available.

string
nullable
Email

User email when available.

string
nullable
AvatarInitials

Avatar initials.

string
nullable
AvatarBackgroundColor

Avatar background color.

string
nullable
AvatarTextColor

Avatar text color.

string
nullable
UserType
integer format: int32
Allowed values: 0 1 2
IsDeleted

Whether the resolved workspace user has been deleted.

boolean
IsMissing

Whether the stored actor identifier no longer resolves to a workspace user.

boolean
OccurredAtUtc
string format: date-time
CorrelationId
string
nullable
TotalCount

Total number of matching ledger rows before pagination.

integer format: int32
Page

One-based page number returned by the query.

integer format: int32
PageSize

Page size applied by the query.

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": [
{
"Operation": 0,
"EntitlementStatus": 0,
"EntitlementEffectiveState": 0,
"SourceType": 0,
"Actor": {
"UserType": 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"
}