Check customer entitlement

Check if a customer has access to a specific benefit by key. This is the primary endpoint for feature gating and licensing checks.

Related endpoints

• GET /customers/{customerId}/entitlements — List customer entitlements
• POST /customers/{customerId}/entitlements — Grant entitlement to customer
• DELETE /customers/{customerId}/entitlements — Revoke entitlement by benefit key
• DELETE /customers/{customerId}/entitlements/{entitlementId} — Revoke entitlement by ID
• GET /entitlements — List entitlements
• GET /entitlements/check — Check entitlement access

Common errors

• 401 unauthenticated — missing, malformed, or revoked API key.
• 404 resource_missing — the referenced resource does not exist or is not visible to your key.

curl "https://api.revkeen.com/v2/customers/00000000-0000-0000-0000-000000000000/entitlements/check?benefitKey=value" \
  -H "x-api-key: $REVKEEN_API_KEY"

{
  "data": {
    "benefit_key": "string",
    "has_access": true,
    "access_level": "full",
    "status": "active",
    "benefit": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "description": "string",
      "benefit_type": "string",
      "benefit_key": "string",
      "category": "string",
      "icon_url": "string",
      "display_order": "string",
      "is_active": true,
      "default_value": null,
      "config": null
    },
    "reason": "string"
  }
}

{
  "error": "Unauthorized"
}

{
  "error": "Not found"
}