---
title: "Get a pricing plan"
method: GET
path: "/v1/pricing-plans/{id}"
tags: ["Pricing Plans"]
---

# Get a pricing plan

`GET /v1/pricing-plans/{id}`

Retrieve a pricing plan by ID.

## Path parameters

- `id` string, required

## Response `200`

Pricing plan details

- object — Pricing plan details
  - `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

## Other responses

- `401` — Unauthorized
- `404` — Pricing plan not found

---

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