Skip to content
Oclavex is in private preview, available to selected users. Public signup is blocked. Request access at [email protected].

GetEntitlementPlan

GET
/api/v1/provision/consumer/me/entitlements/{entitlementId}/plan
curl --request GET \
--url https://example.com/api/v1/provision/consumer/me/entitlements/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/plan
entitlementId
required
string format: uuid

OK

The plan context for an entitlement or session: what is applied, and what is available.

object
entitlementId
string format: uuid
assignedPlanName
null | string
overrideRevertPlanName

The plan a temporary override reverts to, while one is in force.

null | string
overrideReason

Why the temporary override is in force (self-service-signup-trial, payment-lapsed, …); null when none is active. What tells a lapsed account apart from one on a trial.

null | string
appliedPlan
One of:
null
availablePlans
Array<object>

A plan a consumer can see or switch to, and what it includes.

object
id
string format: uuid
name
string
description
string
sortOrder
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
featureValues

What the plan includes: one entry per feature it sets.

Array<object>

One feature’s value for the calling user: a fixed value, or a metered allowance.

object
featureCode
string
featureName

The feature’s display name from the vendor’s catalog, for rendering; null when the server could not resolve the code, in which case the code is all there is to show.

null | string
metricName

The meter a metered feature reads, or null for a fixed value.

null | string
units

What the value is counted in (GB, seats, calls), from the vendor’s catalog; null when it names none.

null | string
enforcementType

SingleValue, TieredAbsolute, TieredPercentage, Denied or NotIncluded, as a stable name; the last two carry no value and no bands.

string
value

The value of a fixed feature — a flag, a count, a setting. Null for a metered one.

null | string
bands

The bands a metered feature is enforced in, in ladder order. Empty for a fixed value.

Array<object>

One band of a metered feature’s ladder: where it starts and ends, and what the plan does there.

object
startUsage
null | number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/
endUsage
null | number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/
quotaUsagePolicy

None, NotifyOnly, AllowWithGrace, AllowWithOverage, RateLimit, Deny or SuspendUsage, as a stable name.

string
effectiveFeatureValues

What the holder is entitled to under the applied plan, add-on grants merged in and internal features left out — the values a license page renders.

Array<object>

One feature’s value for the calling user: a fixed value, or a metered allowance.

object
featureCode
string
featureName

The feature’s display name from the vendor’s catalog, for rendering; null when the server could not resolve the code, in which case the code is all there is to show.

null | string
metricName

The meter a metered feature reads, or null for a fixed value.

null | string
units

What the value is counted in (GB, seats, calls), from the vendor’s catalog; null when it names none.

null | string
enforcementType

SingleValue, TieredAbsolute, TieredPercentage, Denied or NotIncluded, as a stable name; the last two carry no value and no bands.

string
value

The value of a fixed feature — a flag, a count, a setting. Null for a metered one.

null | string
bands

The bands a metered feature is enforced in, in ladder order. Empty for a fixed value.

Array<object>

One band of a metered feature’s ladder: where it starts and ends, and what the plan does there.

object
startUsage
null | number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/
endUsage
null | number | string format: double
/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/
quotaUsagePolicy

None, NotifyOnly, AllowWithGrace, AllowWithOverage, RateLimit, Deny or SuspendUsage, as a stable name.

string

Unauthorized

object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string

Forbidden

object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string

Not Found

object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string

Service Unavailable