v51

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

Entitlements

Get subject entitlement value

This endpoint should be used for access checks and enforcement. All entitlement types share the hasAccess property in their value response, but multiple other properties are returned based on the entitlement type.

For convenience reasons, /value works with both entitlementId and featureKey.

⚠️ Deprecated: Use GET /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/value instead.

get/api/v1/subjects/{subjectIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/value

Path parameters

subjectIdOrKeystring required

entitlementIdOrFeatureKeystring 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\" }"
}