Evaluate one feature for a customer now
const url = 'https://api.seal0.app/v1/entitlements/evaluate';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"customer_id":"example","feature_key":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.seal0.app/v1/entitlements/evaluate \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "customer_id": "example", "feature_key": "example" }'Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
Opaque customer ID from the integrating application.
Feature or plan key.
Example generated
{ "customer_id": "example", "feature_key": "example"}Responses
Section titled “Responses”Evaluation result. A missing entitlement is still 200 with granted=false.
object
object
Reason code; clients must tolerate new codes.
Usage against the limit in the current period, for metered features that resolved a value; null otherwise.
object
Used >= limit. Can be true while the feature is still granted, within the grace margin.
The customer’s current subscription, or null when there is none.
object
A pinned plan version.
object
Feature or plan key.
Example generated
{ "customer_id": "example", "entitlement": { "feature_key": "example", "feature_type": "example", "granted": true, "override_id": "example", "reason": "example", "source": "example", "usage": { "limit": true, "over_limit": true, "period_end": "2026-04-15T12:00:00Z", "period_start": "2026-04-15T12:00:00Z", "remaining": true, "used": 1 }, "valid_until": "2026-04-15T12:00:00Z", "value": true }, "evaluated_at": "2026-04-15T12:00:00Z", "subscription": { "id": "example", "plan": { "key": "example", "version": 1 }, "status": "example" }}Error envelope.
object
object
Stable snake_case error code.
Offending input field, when known.
Example generated
{ "error": { "code": "example", "field": "example", "message": "example", "request_id": "example" }}Error envelope.
object
object
Stable snake_case error code.
Offending input field, when known.
Example generated
{ "error": { "code": "example", "field": "example", "message": "example", "request_id": "example" }}Error envelope.
object
object
Stable snake_case error code.
Offending input field, when known.
Example generated
{ "error": { "code": "example", "field": "example", "message": "example", "request_id": "example" }}Error envelope.
object
object
Stable snake_case error code.
Offending input field, when known.
Example generated
{ "error": { "code": "example", "field": "example", "message": "example", "request_id": "example" }}default
Section titled “default”Error envelope.
object
object
Stable snake_case error code.
Offending input field, when known.
Example generated
{ "error": { "code": "example", "field": "example", "message": "example", "request_id": "example" }}