v1

latestOpenAPI 3.1.02026-08-042453938.9 KB

Pricing Plans

Get a pricing plan

Retrieve a pricing plan by ID.

get/v1/pricing-plans/{id}

Path parameters

idstring required

Pricing plan ID

Response

Pricing plan details

idstring required

Unique identifier for the pricing plan

businessIdstring

Business this plan belongs to

namestring required

Human-readable name for the plan

unitTypestring required

The usage type this plan prices (e.g., "api_call", "token", "compute_second", "gb_storage")

unitPriceUsdstring 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.

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

creditsPerUnitstring nullable

Credits consumed per unit of usage. When set, usage is deducted from the customer's credit wallet instead of charging USD.

productCategoryIdstring 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.

isActiveboolean required

Whether this plan is active. Only active plans are used for new charges.

createdAtstring date-time

When the plan was created

updatedAtstring date-time

When the plan was last updated

Example response

{
  "id": "plan_abc123def456",
  "businessId": "biz_789xyz",
  "name": "API Calls",
  "unitType": "api_call",
  "unitPriceUsd": "0.001000",
  "unitPrice": "0.000920",
  "currency": "USD",
  "pricingModel": "FLAT",
  "tiers": [
    {
      "minQuantity": "0",
      "maxQuantity": "1000",
      "unitPriceUsd": "0.001000",
      "unitPrice": "0.000920",
      "packageSize": 1000
    }
  ],
  "creditsPerUnit": "10",
  "productCategoryId": "cat_core",
  "isActive": true,
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}