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

# List resolved entitlements for a subscription

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

## Path parameters

- `subscription_id` string, MeteroidId, required

## Response `200`

Resolved entitlements for this subscription

- ResolvedEntitlementListResponse
  - `data` ResolvedEntitlement[], required
    - `created_at` string, date-time, required
    - `feature` FeatureRef, required
      - `id` string, MeteroidId, required
      - `name` string, required
      - `product` ProductRef
        - `id` string, MeteroidId, required
        - `name` string, required
    - `origin` ResolvedOrigin, required — Resolved entity that contributed the winning entitlement value, with a human-readable label.
      - `entity` union, required
        - object
          - `id` string, MeteroidId, required
          - `type` 'FEATURE', required
        - object
          - `id` string, MeteroidId, required
          - `type` 'PLAN', required
        - object
          - `id` string, MeteroidId, required
          - `type` 'PLAN_VERSION', required
        - object
          - `id` string, MeteroidId, required
          - `type` 'ADD_ON', required
        - object
          - `id` string, MeteroidId, required
          - `type` 'SUBSCRIPTION', required
        - object
          - `id` string, MeteroidId, required
          - `type` 'QUOTE', required
      - `name` string, nullable
    - `value` union, required
      - object
        - `enabled` boolean, required
        - `type` 'BOOLEAN', required
      - object
        - `enabled` boolean, required
        - `limit` string, nullable
        - `metric_id` string, MeteroidId, required
        - `overage_behavior` union, required — What happens past the limit.
          - object — Deny access once usage reaches the limit. Meteroid does not enforce this — your integration must check and act.
            - `grace_period_pct` integer, nullable
            - `type` 'BLOCK', required
          - object — Keep serving usage past the limit; overage is billed or handled out-of-band.
            - `type` 'ALLOW', required
        - `reset_period` union, required
          - object — Resets at the start of each subscription billing period.
            - `type` 'BILLING_CYCLE', required
          - object — Buckets aligned to the calendar (e.g. every 1st of the month), shared across customers.
            - `interval` integer, required
            - `type` 'CALENDAR', required
            - `unit` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
          - object — Fixed-length buckets anchored on the subscription activation date. Resets at every boundary.
            - `interval` integer, required
            - `type` 'FIXED_WINDOW', required
            - `unit` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
          - object — Continuous rolling window — usage older than the window edge drops out, no fixed reset.
            - `interval` integer, required
            - `type` 'SLIDING_WINDOW', required
            - `unit` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
          - object — Usage accumulates for the life of the subscription — no reset.
            - `type` 'NEVER', required
        - `type` 'METERED', required
        - `warning_threshold_pct` integer, nullable

## Other responses

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

## Changes

- **2026-05-18** (v1) `0cdc37620ffb` — 1 info
  - endpoint added
- **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/0cdc37620ffb/schema)