Skip to main content
GET
/
v1
/
subscriptions
/
entitlements
/
{entitlement_id}
JavaScript
import Hercules from '@usehercules/sdk';

const client = new Hercules({
  apiVersion: '2025-12-09',
  apiKey: process.env['HERCULES_API_KEY'], // This is the default and can be omitted
});

const entitlement = await client.beta.subscriptions.entitlements.get('entitlement_id');

console.log(entitlement.id);
{
  "id": "<string>",
  "name": "<string>",
  "key": "<string>",
  "active": true,
  "livemode": true
}

Authorizations

​
Authorization
string
header
required

API key authentication. Include your API key in the Authorization header as: Bearer

Path Parameters

​
entitlement_id
string
required

The unique identifier of the entitlement

Response

200 - application/json

The entitlement object

The entitlement attached to the plan

​
id
string
required

Unique identifier for the entitlement

​
name
string
required

Display name for the entitlement (e.g., API Access, Premium Support)

​
key
string
required

Unique key to identify the entitlement when checking access in your app

​
active
boolean
required

Whether the entitlement is active and can be attached to plans

​
livemode
boolean
required

Whether this is a live mode entitlement (vs test mode)