List Stripe prices

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns prices from every product in the configured Stripe account, unless narrowed to one product with product_id. A product can have more than one price, such as separate monthly and annual prices for the same plan.

Uses the Stripe account selected by the app's stored credentials. Live keys select the live catalog and test keys select the test catalog. Products and prices belong to that Stripe account, so multiple apps configured with the same account share the same catalog.

Returns a single batch, with no indication that more results exist. This operation cannot retrieve a complete catalog larger than the requested limit.

Requires read access to the app.

get/api/apps/{app_id}/payments/stripe/prices

Path parameters

app_idstring required

ID of the Base44 app.

ID of the Base44 app.

Query parameters

product_idstring nullable

Stripe product ID to filter by. Defaults to no product filter.

Stripe product ID to filter by. Defaults to no product filter.

activeboolean nullable

Filter by active status. Stripe defaults to active-only prices when this is omitted. Pass false to list inactive prices instead.

Filter by active status. Stripe defaults to active-only prices when this is omitted. Pass false to list inactive prices instead.

limitinteger

Maximum number of prices in this batch. Use 1 through 100. Defaults to 100. There is no cursor for another batch.

Maximum number of prices in this batch. Use 1 through 100. Defaults to 100. There is no cursor for another batch.

Response

The operation result.

idstring required

Stripe price ID.

productstring required

Stripe product ID this price belongs to.

unit_amountinteger nullable required

Amount in the currency's smallest unit, or null for pricing without a fixed integer unit amount.

currencystring required

Currency as a lowercase three-letter ISO 4217 code.

activeboolean required

Whether the price is active.

metadataobject required

Metadata stored on the price.

Example response

[
  {
    "id": "price_1T7mK2Q4r6S8v9Ab",
    "product": "prod_T7mK2p9Q4r6S8v",
    "unit_amount": 2500,
    "currency": "usd",
    "active": true,
    "metadata": {
      "tier": "standard"
    },
    "recurring": {
      "interval": "month",
      "interval_count": 1,
      "usage_type": "licensed"
    }
  }
]

Changes

Changed in 1 of the 14 revisions of this API.1