---
title: "List add-on entitlements"
method: GET
path: "/api/v1/addons/{addon_id}/entitlements"
tags: ["Add-ons", "Entitlements"]
---

# List add-on entitlements

`GET /api/v1/addons/{addon_id}/entitlements`

## Path parameters

- `addon_id` string, MeteroidId, required

## Response `200`

Resolved entitlements for this add-on

- ResolvedEntitlementListResponse
  - `data` ResolvedEntitlement[], 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
      - BooleanResolvedEntitlementValue
        - `enabled` boolean, required
      - MeteredResolvedEntitlementValue
        - `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.
            - `interval` integer, required
            - `unit` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
          - FixedWindowResetPeriod — Resets at regular intervals — anchored to your subscription's exact activation time.
            - `interval` integer, required
            - `unit` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
          - SlidingWindowResetPeriod — Always ends at now — e.g. 30 days means the last 30 days, old usage drops off automatically.
            - `interval` integer, required
            - `unit` 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required
          - NeverResetPeriod — Never resets — counts all usage since the subscription was activated.

## Other responses

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

## Changes

- **2026-08-12** (v1) `4e013b4e4a8f` — 1 breaking, 1 info
  - added `#/components/schemas/EntitlementProductRef` to the `data/items/feature/product` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/ProductRef` from the `data/items/feature/product` response property `oneOf` list for the response status `200`
- **2026-06-30** (v1) `cf74b98b2838` — 1 info
  - added the required property `data/items/feature/code` to the response with the `200` status
- **2026-06-05** (v1) `a890ac9a23e9` — 1 breaking
  - removed the required property `data/items/origin` from the response with the `200` status
- **2026-06-01** (v1) `07a61fe347a5` — 1 breaking, 1 warning
  - removed the required property `data/items/value/oneOf[#/components/schemas/MeteredResolvedEntitlementValue]/overage_behavior` from the response with the `200` status
  - removed the optional property `data/items/value/oneOf[#/components/schemas/MeteredResolvedEntitlementValue]/warning_threshold_pct` from the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/addons/:addon_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)