Skip to content

Return one renewal workflow operation.

GET
/api/workspace/entitlement-operations/renewal-operations/{renewalOperationId}
curl --request GET \
--url https://example.com/api/workspace/entitlement-operations/renewal-operations/example
  • None
renewalOperationId
required
string
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

Runtime renewal operation detail for scheduled, manual, retried, or cancelled renewal work.

object
Id

Stable renewal operation identifier.

string
nullable
EntitlementId

Entitlement targeted by the renewal operation.

string
nullable
EntitlementNumber

Human-readable entitlement number for support and external references.

integer format: int64
EntitlementPlanId

Plan associated with the targeted entitlement.

string
nullable
EntitlementPlanDisplayName

Display name of the associated plan.

string
nullable
EntitlementModelId

Entitlement model that owns the targeted entitlement.

string
nullable
EntitlementModelDisplayName

Display name of the owning entitlement model.

string
nullable
EntitlementPeriodId

Entitlement period that caused or receives the renewal operation when available.

string
nullable
RenewalPolicyId

Renewal policy snapshot used by the operation when available.

string
nullable
RenewalPolicyKey

Business key of the renewal policy when available.

string
nullable
OperationKind
integer format: int32
Allowed values: 0 1
DueAtUtc

UTC instant when the renewal operation is due.

string format: date-time
Status
integer format: int32
Allowed values: 0 1 2 3 4
CompletedAtUtc

UTC instant when the operation completed successfully.

string format: date-time
nullable
CompletedByUserId

User id that completed the operation when it was user-driven.

string
nullable
ExternalReference

Optional external payment, subscription, or integration reference.

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

Optional source metadata captured with the operation.

string
nullable
FailureCode

Structured failure code from the last failed attempt.

string
nullable
FailureMessage

Human-readable failure message from the last failed attempt.

string
nullable
CancelledAtUtc

UTC instant when the operation was cancelled.

string format: date-time
nullable
CancelledByUserId

User id that cancelled the operation when available.

string
nullable
CancelReason

Optional cancellation reason.

string
nullable
RelatedLedgerEntries

Ledger entries produced by or related to the operation.

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
RowVersion

Optimistic concurrency token for renewal operation mutations.

string format: uuid
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": {
"OperationKind": 0,
"Status": 0,
"SourceType": 0,
"RelatedLedgerEntries": [
{
"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"
}

Not Found

Media typeapplication/json
object
Data

Runtime renewal operation detail for scheduled, manual, retried, or cancelled renewal work.

object
Id

Stable renewal operation identifier.

string
nullable
EntitlementId

Entitlement targeted by the renewal operation.

string
nullable
EntitlementNumber

Human-readable entitlement number for support and external references.

integer format: int64
EntitlementPlanId

Plan associated with the targeted entitlement.

string
nullable
EntitlementPlanDisplayName

Display name of the associated plan.

string
nullable
EntitlementModelId

Entitlement model that owns the targeted entitlement.

string
nullable
EntitlementModelDisplayName

Display name of the owning entitlement model.

string
nullable
EntitlementPeriodId

Entitlement period that caused or receives the renewal operation when available.

string
nullable
RenewalPolicyId

Renewal policy snapshot used by the operation when available.

string
nullable
RenewalPolicyKey

Business key of the renewal policy when available.

string
nullable
OperationKind
integer format: int32
Allowed values: 0 1
DueAtUtc

UTC instant when the renewal operation is due.

string format: date-time
Status
integer format: int32
Allowed values: 0 1 2 3 4
CompletedAtUtc

UTC instant when the operation completed successfully.

string format: date-time
nullable
CompletedByUserId

User id that completed the operation when it was user-driven.

string
nullable
ExternalReference

Optional external payment, subscription, or integration reference.

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

Optional source metadata captured with the operation.

string
nullable
FailureCode

Structured failure code from the last failed attempt.

string
nullable
FailureMessage

Human-readable failure message from the last failed attempt.

string
nullable
CancelledAtUtc

UTC instant when the operation was cancelled.

string format: date-time
nullable
CancelledByUserId

User id that cancelled the operation when available.

string
nullable
CancelReason

Optional cancellation reason.

string
nullable
RelatedLedgerEntries

Ledger entries produced by or related to the operation.

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
RowVersion

Optimistic concurrency token for renewal operation mutations.

string format: uuid
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": {
"OperationKind": 0,
"Status": 0,
"SourceType": 0,
"RelatedLedgerEntries": [
{
"Operation": 0,
"EntitlementStatus": 0,
"EntitlementEffectiveState": 0,
"SourceType": 0,
"Actor": {
"UserType": 0
}
}
]
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}