---
title: "List pricing plans"
method: GET
path: "/v1/pricing-plans"
tags: ["Pricing Plans"]
---

# List pricing plans

`GET /v1/pricing-plans`

Get all pricing plans for your business.

## Response `200`

List of pricing plans

- object — List of pricing plans
  - `data` object[]
    - `id` string, required — Unique identifier for the pricing plan
    - `businessId` string — Business this plan belongs to
    - `name` string, required — Human-readable name for the plan
    - `unitType` string, required — The usage type this plan prices (e.g., "api_call", "token", "compute_second", "gb_storage")
    - `unitPriceUsd` string, required — Default (FLAT) price per unit in USD. For TIERED/VOLUME/PACKAGE plans, consult `tiers`. For PER_SEAT plans, this is the price per seat per billing period.
    - `unitPrice` string, nullable — Native-currency price per unit. Populated only for non-USD plans (e.g. EUR, ILS). When set, this is the source of truth: the billing engine reads it directly and converts to USD via FxRate at charge time.
    - `currency` 'USD' | 'USDC' | 'EUR' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'CHF' | 'SGD' | 'HKD' | 'ILS' | 'NZD' | 'SEK' | 'NOK' | 'DKK' | 'MXN' | 'BRL' | 'INR' | 'ZAR' | 'PLN' — Billing currency for the plan. Defaults to USD. For non-USD currencies, supply `unitPrice` (and tier `unitPrice`/`flatFee`); the billing engine uses those as the source of truth and converts to USD via FxRate at charge time.
    - `pricingModel` 'FLAT' | 'TIERED' | 'VOLUME' | 'PACKAGE' | 'PER_SEAT', required — How quantity maps to charge amount: - `FLAT`: quantity × unitPrice (default) - `TIERED`: graduated, first N at price A, next M at price B, etc. - `VOLUME`: total quantity determines a single rate applied to all units - `PACKAGE`: charge per package of N units (rounds up partial packages) - `PER_SEAT`: per-seat/user licensing. quantity is the seat count, charged at unitPrice per seat per billing period (no tiers)
    - `tiers` object[], required — Tier definitions. Empty for FLAT and PER_SEAT plans; required for TIERED/VOLUME/PACKAGE.
      - `id` string — Tier ID (present on existing tiers)
      - `minQuantity` string, required — Tier starts at this quantity (inclusive). First tier must be 0.
      - `maxQuantity` string, nullable — Tier ends at this quantity (exclusive). Null on the final unbounded tier.
      - `unitPriceUsd` string, required — Price per unit in this tier (USD)
      - `flatFeeUsd` string, nullable — Optional flat fee added when this tier is reached
      - `unitPrice` string, nullable — Native-currency price per unit. Populated only for non-USD plans (e.g. EUR, ILS). When set, this is the source of truth and the legacy unitPriceUsd is ignored by the billing engine.
      - `flatFee` string, nullable — Native-currency flat fee. Populated only for non-USD plans (mirror of flatFeeUsd).
      - `packageSize` integer, nullable — For PACKAGE model: number of units in one billable package
    - `creditsPerUnit` string, nullable — Credits consumed per unit of usage. When set, usage is deducted from the customer's credit wallet instead of charging USD.
    - `productCategoryId` string, nullable — Optional product category tag used by 'strict products' mode to roll up reporting by service line. Null when the plan is untagged. When `Business.strictProducts` is true, this must be populated via the category id or key.
    - `isActive` boolean, required — Whether this plan is active. Only active plans are used for new charges.
    - `createdAt` string, date-time — When the plan was created
    - `updatedAt` string, date-time — When the plan was last updated
  - `count` integer

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/versions/2cb1567969ca/schema)