Evaluate entitlement with usage simulation

Evaluates whether a customer can access a feature, with optional pre-flight usage simulation.

Without track: Returns an isAllowed decision with a reason — identical in outcome to the GET check, but usable when you need a POST interface.

With track: Simulates whether the proposed usageUnits would be permitted under the customer's current plan limits — without recording real consumption. Use this to pre-flight expensive operations before they happen: check if a customer has 10,000 tokens remaining before firing an LLM call, for example. A zero-usage audit event is always written for traceability.

Important: When track is provided without usageUnits, the simulation assumes 1 unit. This endpoint does not record billable usage — to meter actual consumption, use the Events endpoint (POST /api/v1/client/events).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length ≤ 128

Your external reference ID for the customer.

string
required
length ≤ 128

The unique key of the feature to evaluate.

track
object

Optional tracking context for usage simulation. When provided, the system simulates whether the proposed usage would be allowed. A zero-usage audit event is recorded.

context
object

Optional correlation context for tracing and debugging.

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json