---
title: "List billing plans for a product"
method: GET
path: "/v1/products/{productSlug}/plans"
tags: ["Vercel"]
---

# List billing plans for a product

`GET /v1/products/{productSlug}/plans`

## Request

- Base URL: `https://api.xata.tech`
- URL: `https://api.xata.tech/v1/products/{productSlug}/plans`
- Auth: none declared

Return the product's available billing plans, rendered into Vercel's
billingPlan shape. Vercel calls this to show plans when a customer creates
a resource; it may be called before any installation exists, so the signed
token can carry no installation or account id. Plans are billing SKUs only
and do not change Xata entitlements (every Vercel org is T2).

## Path parameters

- `productSlug` string, required

## Query parameters

- `metadata` string

## Response `200`

The product's billing plans.

- ListBillingPlansResponse: The billing plans available for a product.
  - `plans` BillingPlan[], required
    - `id` string, required: Partner-provided billing plan id.
    - `type` string, required: Plan type: "subscription" or "prepayment".
    - `name` string, required
    - `description` string, required
    - `scope` string: Plan scope; installation-level plans require enablement on the integration.
    - `paymentMethodRequired` boolean: Subscription plans only. false means the plan is completely free.
    - `preauthorizationAmount` number: Subscription + paymentMethodRequired. Amount used to test the payment method; never charged.
    - `initialCharge` string: Subscription + paymentMethodRequired. Amount invoiced immediately at sign-up (decimal USD string).
    - `cost` string: Display cost for fixed-cost plans, e.g. "$20.00/month". Omitted for usage-based plans.
    - `details` PlanDetail[]
      - `label` string, required
      - `value` string
    - `highlightedDetails` PlanDetail[]
      - `label` string, required
      - `value` string
    - `quote` PlanQuoteLine[]
      - `line` string, required
      - `amount` string, required
    - `effectiveDate` string
    - `disabled` boolean

## Other responses

- `400`: Error response.
- `403`: Error response.
- `404`: Error response.

## Changes

- **2026-09-04** `57f46d379e2a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/xataio/apis/xata-api/changes/v1/products/:productSlug/plans/get.md)

---

[API](https://skmtc.dev/xataio/apis/xata-api.md) - [All operations](https://skmtc.dev/xataio/apis/xata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/xataio/apis/xata-api/revisions/4bc5ad58a6c6?raw)