***

title: Entitlements
subtitle: Check feature access and retrieve entitlement balances
slug: endpoints/entitlements
---------------------

For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://docs.prolifi.io/endpoints/llms.txt. For full documentation content, see https://docs.prolifi.io/endpoints/llms-full.txt.

Entitlements represent what a customer is allowed to access based on their active subscriptions. Use these endpoints for real-time feature gating and quota checks in your application.

## Endpoints

| Method | Path                           | Description                                           |
| ------ | ------------------------------ | ----------------------------------------------------- |
| `POST` | `/entitlements/check`          | Check if a customer is entitled to a specific feature |
| `GET`  | `/customers/{id}/entitlements` | Get all entitlements for a customer                   |

## Key concepts

* **Entitlement check**: The check endpoint returns a single `entitled: true/false` result for a specific feature. Use this for real-time access control (e.g., before allowing an API call or file upload).
* **Requested quantity**: Optionally pass `requested_quantity` to check if the customer has at least N units remaining. Defaults to 1.
* **Unlimited entitlements**: Some features may be unlimited (`is_unlimited: true`). For these, `remaining` is `null` and the customer is always entitled.
* **Deduplication**: When a customer has the same feature from multiple subscriptions, the highest limit (or unlimited) is returned.
* **Reset period**: The `reset_at` field indicates when the entitlement counter resets (typically the next billing period start).