Sign in

v51

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2026-08-011534301009.2 KB
Entitlements
Customers

Get customer entitlement value

Checks customer access to a given feature (by key). All entitlement types share the hasAccess property in their value response, but multiple other properties are returned based on the entitlement type.

get/api/v1/customers/{customerIdOrKey}/entitlements/{featureKey}/value

Path parameters

string required

ULID (Universally Unique Lexicographically Sortable Identifier).

OR
string required

ExternalKey is a looser version of key.

Example:01G65Z755AFWAKHE12NY0CQ9FH
featureKeystring required

Query parameters

timestring date-time
Example:2023-01-01T01:01:01.001Z

Response

The request has succeeded.

hasAccessboolean required

Whether the subject has access to the feature. Shared accross all entitlement types.

balancenumber double

Only available for metered entitlements. Metered entitlements are built around a balance calculation where feature usage is deducted from the issued grants. Balance represents the remaining balance of the entitlement, it's value never turns negative.

usagenumber double

Only available for metered entitlements. Returns the total feature usage in the current period.

overagenumber double

Only available for metered entitlements. Overage represents the usage that wasn't covered by grants, e.g. if the subject had a total feature usage of 100 in the period but they were only granted 80, there would be 20 overage.

totalAvailableGrantAmountnumber double

Only available for metered entitlements. The summed amount of all grant active at query time PLUS the used amount of since inactive grants.

configstring

Only available for static entitlements. The JSON parsable config of the entitlement.

Example response

{
  "hasAccess": true,
  "balance": 100,
  "usage": 50,
  "totalAvailableGrantAmount": 100,
  "config": "{ key: \"value\" }"
}