---
title: "Resolved plan limits, allowances and policies of an organization"
method: GET
path: "/v1/organizations/{organization_id}/entitlements"
tags: ["Entitlements"]
---

# Resolved plan limits, allowances and policies of an organization

`GET /v1/organizations/{organization_id}/entitlements`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/organizations/{organization_id}/entitlements`
- Auth: HTTP bearer

## Path parameters

- `organization_id` string, uuid, required

## Response `200`

Default Response

- object
  - `organization_id` string, uuid, required: UUIDv7, lowercase canonical form.
  - `plan` object, nullable, required
    - `plan_key` string, required
    - `catalog_version` string, required
    - `source` union, required
      - 'override'
      - 'subscription'
      - 'trial'
      - 'default'
    - `ends_at` string, date-time, nullable, required: RFC 3339 UTC timestamp with Z.
  - `limits` object, required: Resolved plan limits (null = unlimited).
  - `allowances` object, required
  - `policies` object, required
  - `restrictions` object, required: Active admission restrictions, e.g. `new_starts` {reason, since, grace_until} after a payment grace period ended.
  - `resolved_at` string, date-time, required: RFC 3339 UTC timestamp with Z.

## Other responses

- `4XX`: Default Response
- `5XX`: Default Response

---

[API](https://skmtc.dev/shardflux/apis/shardflux-api.md) · [All operations](https://skmtc.dev/shardflux/apis/shardflux-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shardflux/apis/shardflux-api/revisions/ea685f7b39c4?raw)
