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

GetEntitlementPlans

GET
/api/v1/provision/consumer/me/entitlements/{entitlementId}/plans
curl --request GET \
--url 'https://example.com/api/v1/provision/consumer/me/entitlements/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/plans?pageNumber=1&pageSize=100'
entitlementId
required
string format: uuid
pageNumber
integer | string format: int32
default: 1 /^-?(?:0|[1-9]\d*)$/
pageSize
integer | string format: int32
default: 100 /^-?(?:0|[1-9]\d*)$/

OK

Serializable IPaginatedList<T> implementation used to deserialize paged API responses. int PaginatedListDto<T>.TotalPages, bool PaginatedListDto<T>.HasPreviousPage, and bool PaginatedListDto<T>.HasNextPage are computed from the other properties.

object
pageNumber

The 1-based index of this page within the full result set.

integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
pageSize

The maximum number of items per page that was requested.

integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
totalCount

The total number of items across all pages.

integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
items

The items on this page.

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
totalPages

The total number of pages, computed from int PaginatedListDto<T>.TotalCount and int PaginatedListDto<T>.PageSize; 0 when int PaginatedListDto<T>.PageSize is not positive.

integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
hasPreviousPage

Whether a page precedes this one (int PaginatedListDto<T>.PageNumber is greater than 1).

boolean
hasNextPage

Whether a page follows this one (int PaginatedListDto<T>.PageNumber is less than int PaginatedListDto<T>.TotalPages).

boolean

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