OPopenmeter
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

Request

  • Base URL
    https://openmeter.cloud (the document declares no server; this is the origin it was published from)
  • Auth
    • HTTP bearer
    • or API key in cookie __session

Path parameters

subjectIdOrKeystring required
entitlementIdOrFeatureKeystring required

Query parameters

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

Response

The request has succeeded.

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.

configstring

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

hasAccessboolean required

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

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.

usagenumber double

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

Example response

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

Changes

No recorded changes to this operation across all 2 revisions of this API.