---
title: "Retrieve an active entitlement"
method: GET
path: "/v1/entitlements/active_entitlements/{id}"
---

# Retrieve an active entitlement

`GET /v1/entitlements/active_entitlements/{id}`

Retrieve an active entitlement

## Path parameters

- `id` string, required

## Query parameters

- `expand` string[]

## Response `200`

Successful response.

- EntitlementsActiveEntitlement — An active entitlement describes access to a feature for a customer.
  - `feature` union, required — The [Feature](https://docs.stripe.com/api/entitlements/feature) that the customer is entitled to.
    - string
    - EntitlementsFeature — A feature represents a monetizable ability or functionality in your system. Features can be assigned to products, and when those products are purchased, Stripe will create an entitlement to the feature for the purchasing customer.
      - `active` boolean, required — Inactive features cannot be attached to new products and will not be returned from the features list endpoint.
      - `id` string, required — Unique identifier for the object.
      - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
      - `lookup_key` string, required — A unique key you provide as your own system identifier. This may be up to 80 characters.
      - `metadata` object, required — Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
      - `name` string, required — The feature's name, for your own purpose, not meant to be displayable to the customer.
      - `object` 'entitlements.feature', required — String representing the object's type. Objects of the same type share the same value.
  - `id` string, required — Unique identifier for the object.
  - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
  - `lookup_key` string, required — A unique key you provide as your own system identifier. This may be up to 80 characters.
  - `object` 'entitlements.active_entitlement', required — String representing the object's type. Objects of the same type share the same value.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/stripe/apis/spec3.md) · [All operations](https://skmtc.net/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/3653ad45bbec/schema)