---
title: "List all billing prices"
method: GET
path: "/billing/prices"
tags: ["Billing"]
---

# List all billing prices

`GET /billing/prices`

Returns a list of all prices for the instance. The prices are returned sorted by amount ascending,
then by creation date descending. This includes both default and custom prices. Pagination is supported.

## Query parameters

- `paginated` boolean
- `limit` integer
- `offset` integer
- `plan_id` string

## Response `200`

A list of billing prices.

- PaginatedBillingPriceResponse
  - `data` BillingPriceResponse[], required — Array of prices.
    - `object` 'commerce_price', required — String representing the object's type. Objects of the same type share the same value.
    - `id` string, required — Unique identifier for the price.
    - `plan_id` string, required — Unique identifier for the associated plan.
    - `instance_id` string, required — Unique identifier for the instance.
    - `currency` string, required — The currency code (e.g., "USD").
    - `currency_symbol` string, required — The currency symbol (e.g., "$").
    - `amount` integer, required — The amount in cents for the price.
    - `annual_monthly_amount` integer, required — The monthly amount in cents when billed annually.
    - `fee` CommerceMoneyResponse, required
      - `amount` integer, required — The amount in cents.
      - `amount_formatted` string, required — The formatted amount as a string (e.g., "$49.99").
      - `currency` string, required — The currency code (e.g., "USD").
      - `currency_symbol` string, required — The currency symbol (e.g., "$").
    - `annual_monthly_fee` CommerceMoneyResponse, required
      - `amount` integer, required — The amount in cents.
      - `amount_formatted` string, required — The formatted amount as a string (e.g., "$49.99").
      - `currency` string, required — The currency code (e.g., "USD").
      - `currency_symbol` string, required — The currency symbol (e.g., "$").
    - `description` string, nullable — The description of the price.
    - `is_default` boolean, required — Whether this price is the default price for its plan.
    - `created_at` integer, required — Unix timestamp (milliseconds) of creation.
    - `supported_billing_periods` 'month' | 'annual' | 'both', required — Which billing periods this price supports.
  - `total_count` integer, required — Total number of prices.

## Other responses

- `400` — Request was not successful
- `401` — Authentication invalid
- `404` — Resource not found
- `422` — Invalid request parameters
- `500` — Request was not successful

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/75df3a43fcb2/schema)