Sample - Stripe API
GET/v1/prices/{price}

Retrieve a price

Retrieves a price by its unique identifier. Use the returned price details to inspect its currency, product association, billing configuration, and availability for new purchases.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
pricestringrequired
The unique identifier of the price to retrieve. Must be no longer than 5000 characters.
expandarray<string>optional
Specifies response fields to expand.

2 status codes
200Returns the requested price object, including its identifier, currency, product association, billing scheme, active state, and other price configuration.
activebooleanrequired
Whether the price can be used for new purchases.
billing_schemestringrequired
Describes how to compute the price per period. Either `per_unit` or `tiered`. `per_unit` indicates that the fixed amount (specified in `unit_amount` or `unit_amount_decimal`) will be charged per unit in `quantity` (for prices with `usage_type=licensed`), or per unit of total usage (for prices with `usage_type=metered`). `tiered` indicates that the unit pricing will be computed using a tiering strategy as defined using the `tiers` and `tiers_mode` attributes.
Allowed:per_unittiered
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
currencystringrequired
Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
currency_optionsobjectoptional
Prices defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies).
custom_unit_amountobjectoptional
When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
lookup_keystringoptional
A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
metadataobjectrequired
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
nicknamestringoptional
A brief description of the price, hidden from customers.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:price
productstringrequired
The ID of the product this price is associated with.
recurringobjectoptional
The recurring components of a price such as `interval` and `usage_type`.
tax_behaviorstringoptional
Only required if a [default tax behavior](https://docs.stripe.com/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
Allowed:exclusiveinclusiveunspecified
tiersarray<PriceTier>optional
Each element represents a pricing tier. This parameter requires `billing_scheme` to be set to `tiered`. See also the documentation for `billing_scheme`.
tiers_modestringoptional
Defines if the tiering price should be `graduated` or `volume` based. In `volume`-based tiering, the maximum quantity within a period determines the per unit price. In `graduated` tiering, pricing can change as the quantity grows.
Allowed:graduatedvolume
transform_quantityobjectoptional
Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with `tiers`.
typestringrequired
One of `one_time` or `recurring` depending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
Allowed:one_timerecurring
unit_amountintegeroptional
The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if `billing_scheme=per_unit`.
unit_amount_decimalstringoptional
The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if `billing_scheme=per_unit`.
defaultReturns an error object containing an error type and details about the failed request.
errorobjectrequired

Error handling

price must identify the price to retrieve and must be a string no longer than 5000 characters. Use the price identifier returned when the price was created or listed.