---
title: "The active plan catalog (the same versioned catalog admission enforces)"
method: GET
path: "/v1/billing/catalog"
tags: ["Billing"]
---

# The active plan catalog (the same versioned catalog admission enforces)

`GET /v1/billing/catalog`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/billing/catalog`
- Auth: none declared

Public, cacheable. Prices are in minor units; `purchasable` plans can be bought with POST .../organizations/{id}/billing/checkout-sessions (a browser or CLI session; `shard billing upgrade <plan>`).

## Response `200`

Default Response

- object
  - `catalog_version` string, required
  - `mode` union, required
    - 'test'
    - 'live'
  - `currency` string, required
  - `activation_at` string, date-time, required: RFC 3339 UTC timestamp with Z.
  - `approved_commercial` boolean, required
  - `plans` object[], required
    - `plan_key` string, required
    - `name` string, required
    - `priority` string, required
    - `overage` string, required
    - `limits` object, required: Admission limits (null = unlimited).
    - `allowances` object, required
    - `grant_days` integer, nullable, required: Days a grant of this plan lasts (the signup trial); its allowances count over the grant, not the month, and at its end or its CPU/RAM cap the organization is back on the default plan. null: a plan that is sold (or the default).
    - `prices` object[], required
      - `interval` union, required
        - 'month'
        - 'year'
      - `amount_minor` integer, required: Price in the currency’s minor unit (cents).
      - `currency` string, required
      - `purchasable` boolean, required: Bound to a Stripe price of this environment’s mode (checkout accepts it).
  - `policies` object, required: Grace, cancellation, overage and retention policies of this catalog version.
  - `units` object, required

## 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)