---
title: "List subscription entitlements"
method: GET
path: "/api/v1/subscriptions/{subscription_id}/entitlements"
tags: ["Subscriptions", "Entitlements"]
---

# List subscription entitlements

`GET /api/v1/subscriptions/{subscription_id}/entitlements`

## Path parameters

- `subscription_id` string, MeteroidId, required

## Response `200`

Effective entitlements for this subscription, with live usage

- EffectiveEntitlementListResponse
  - `data` EffectiveEntitlement[], required
    - `feature` FeatureRef, required
      - `code` string, required — Unique key used to reference this feature in your code. Cannot be changed after creation.
      - `id` string, MeteroidId, required
      - `name` string, required
      - `product` EntitlementProductRef — Minimal reference to the product a feature belongs to.
        - `id` string, MeteroidId, required
        - `name` string, required
    - `value` union, required
      - BooleanEffectiveEntitlementValue
        - `enabled` boolean, required
      - MeteredEffectiveEntitlementValue
        - `spec` MeteredEntitlementSpec, required
          - `enabled` boolean, required
          - `limit` string, decimal, nullable
          - `metric_id` string, MeteroidId, required
          - `reset_period` union, required
            - BillingCycleResetPeriod — Resets each time your subscription renews — anchored to your billing cycle.
            - CalendarResetPeriod — Resets on calendar boundaries (e.g. the 1st of every month) — not tied to subscription start date.
              - …
            - FixedWindowResetPeriod — Resets at regular intervals — anchored to your subscription's exact activation time.
              - …
            - SlidingWindowResetPeriod — Always ends at now — e.g. 30 days means the last 30 days, old usage drops off automatically.
              - …
            - NeverResetPeriod — Never resets — counts all usage since the subscription was activated.
        - `usage` MeteredEntitlementUsage, required
          - `consumed` string, decimal, nullable
          - `remaining` string, decimal, nullable
          - `reset_at` string, date-time, nullable

## Other responses

- `401` — Unauthorized
- `404` — Subscription not found
- `429` — Too many requests

## Changes

> 54 revisions in range; 49 could not be searched.

- **2026-06-30** (v1) `cf74b98b2838` — 1 info
  - added the required property `data/items/feature/code` to the response with the `200` status
- **2025-07-09** (v1) `dece17f86f99` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/subscriptions/:subscription_id/entitlements/get.md)

---

[API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) · [All operations](https://skmtc.dev/meteroid-oss/apis/meteroid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/meteroid-oss/meteroid/revisions/03f9d8ae5c5e/schema)