Sample - Stripe API
GET/v1/prices

List all prices

Lists active or inactive prices, excluding inline prices by default. Use active, currency, product, recurring, or type to filter the results, and use cursor parameters to navigate between pages.

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

11 parameters
activebooleanoptional
Filters prices by active state; pass false to list inactive prices.
createdobjectoptional
Filters by creation time using a Unix timestamp or a range with `gt`, `gte`, `lt`, or `lte`.
currencystringoptional
Filters prices by a supported lowercase three-letter ISO currency code.
ending_beforestringoptional
An object ID cursor that fetches the page before the specified price.
expandarray<string>optional
Specifies response fields to expand.
limitintegeroptional
The number of prices to return. Must be between 1 and 100 and defaults to 10 when omitted.
lookup_keysarray<string>optional
Filters by price lookup keys. You can specify up to 10 lookup keys.
productstringoptional
Filters prices associated with the specified product.
recurringobjectoptional
Filters recurring prices by `interval` (`day`, `month`, `week`, or `year`), `meter`, and `usage_type` (`licensed` or `metered`).
starting_afterstringoptional
An object ID cursor that fetches the page after the specified price.
typestringoptional
Filters by price type: `one_time` or `recurring`.
Allowed:one_timerecurring

2 status codes
200Returns a price list containing price objects, a `has_more` pagination flag, the list object type, and the list URL.
dataarray<Price>required
Details about each object.
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
Allowed:list
urlstringrequired
The URL where this list can be accessed.
defaultReturns an error object containing an error type and details about the failed request.
errorobjectrequired

Error handling

limit must be between 1 and 100 and defaults to 10 when omitted. type must be one of one_time or recurring, and recurring filters must use the supported interval and usage_type values. Use starting_after or ending_before as an object ID when paginating.