---
title: "Query Stripe Prices"
method: GET
path: "/billing/prices"
tags: ["Billing"]
---

# Query Stripe Prices

`GET /billing/prices`

Used to query Prices in Stripe

## Query parameters

- `active` boolean
- `legacy` boolean
- `product_id` string
- `interval` 'month' | 'quarter' | 'annual' — Interval of the Stripe Subscription billing cycle

## Response `200`

Results of the query

- MablStripePriceQueryResult
  - `prices` MablStripePrice[] — All Stripe Prices that matched the query
    - `id` string — Unique identifier for the Price
    - `object` string — String representing the object’s type
    - `active` boolean — Whether the Price can be used for new purchases
    - `billing_scheme` string — Describes how to compute the Price per period
    - `metadata` MablStripePriceMetadata — Set of arbitrary key-value pairs you can attach to the Price
      - `legacy` boolean — Whether the Price is legacy or not
    - `nickname` string — A brief description of the Price, hidden from customers
    - `product` string — The ID of the Stripe Product this Price is associated with
    - `recurring` object — The recurring components of a Price such as interval and usage_type
      - `aggregate_usage` string — Specifies a usage aggregation strategy for prices of usage_type=metered
      - `interval` string — The frequency at which a subscription is billed
      - `interval_count` integer — The number of intervals (specified in the interval attribute) between subscription billings
      - `usage_type` string
    - `unit_amount` integer — The unit amount in cents to be charged, represented as a whole integer if possible. Only set if billing_scheme=per_unit

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `default` — Unknown error

---

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