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

Returns the entitlements assigned to the authenticated principal with pagination, sorting, and filtering, optionally scoped to an application.

GET
/api/v1/provision/consumer/me/entitlements
curl --request GET \
--url 'https://example.com/api/v1/provision/consumer/me/entitlements?pageNumber=1&pageSize=100'
applicationScope
string

Optional application scope filter.

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

1-based page number to return.

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

Maximum number of items per page.

sortOrder
string

Optional sort expression; ascending when omitted.

filter
string

Optional filter expression applied to the results.

Returns the list of entitlements assigned to the caller.

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>

An entitlement granted to the calling user.

object
id
string format: uuid
name
null | string
version
null | string
description
null | string
licenseTermsUrl

Link to the license terms (EULA) the licence was issued under; null when there are none.

null | string
planName
null | string
isTrial
null | boolean
expirationDateTime
null | string format: date-time
subscriptionStatus

The holder’s own view of the subscription — Pending, Trialing, Active, Paused, Expired, … as a stable name — never the vendor’s lifecycle status.

string
licenseKey

The key the licence was issued under, when the holder is meant to see one.

null | string
products

The products this entitlement licenses.

Array<object>

A product named on an entitlement, as the holder sees it.

object
name
string
productCode
null | string
productVersion

The version of the product the licence covers; empty when the product has none.

null | 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

If the user is not authenticated.

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

The caller lacks the user-session scope, or no user on the environment matches its sign-in (license.unknown_user).

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

The user directory could not be reached to look the signed-in user up (service.unavailable); retry with backoff.