List prices
A client-facing price for a product, Stripe-shaped: one number in minor units (or a tier list), never a formula. Optionally for one ensemble (the 10-piece’s reception price). Write-once once sold: retire with status and mint another.
Query Parameters
- Type: integerlimitmin:0max:200
Page size, 50 by default, 200 at most.
- Type: integeroffsetmin:0
Records to skip.
- Type: stringsort
Comma-separated fields; prefix with
-for descending. Sortable: label, status, order, lookup_key, billing_scheme, unit_amount, currency, tiers, tiers_mode, product_id, ensemble_id, created_time, last_edited_time, id. Default: order,unit_amount. - Type: stringfields
Comma-separated subset of fields to return.
idis always included. - filter[label]
Shorthand
filter[label]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.- Type: string
Shorthand
filter[label]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
- filter[status]
Shorthand
filter[status]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.- Type: "active" or "inactive"enum
Shorthand
filter[status]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.
- filter[order]
Shorthand
filter[order]=valuemeans equals. Operators: equals, does_not_equal, greater_than, less_than, greater_than_or_equal_to, less_than_or_equal_to, is_empty, is_not_empty.- Type: number
Shorthand
filter[order]=valuemeans equals. Operators: equals, does_not_equal, greater_than, less_than, greater_than_or_equal_to, less_than_or_equal_to, is_empty, is_not_empty.
- filter[lookup
_key] Shorthand
filter[lookup_key]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.- Type: string
Shorthand
filter[lookup_key]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
- filter[billing
_scheme] Shorthand
filter[billing_scheme]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.- Type: "per_unit" or "tiered"enum
Shorthand
filter[billing_scheme]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.
- filter[unit
_amount] Shorthand
filter[unit_amount]=valuemeans equals. Operators: equals, does_not_equal, greater_than, less_than, greater_than_or_equal_to, less_than_or_equal_to, is_empty, is_not_empty.- Type: number
Shorthand
filter[unit_amount]=valuemeans equals. Operators: equals, does_not_equal, greater_than, less_than, greater_than_or_equal_to, less_than_or_equal_to, is_empty, is_not_empty.
- filter[currency]
Shorthand
filter[currency]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.- Type: string
Shorthand
filter[currency]=valuemeans equals. Operators: equals, does_not_equal, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty.
- filter[tiers]
Shorthand
filter[tiers]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.Shorthand
filter[tiers]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.- additionalPropertyType: anythingproperty
Name
- filter[tiers
_mode] Shorthand
filter[tiers_mode]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.- Type: "graduated" or "volume"enum
Shorthand
filter[tiers_mode]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.
- filter[product
_id] Shorthand
filter[product_id]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.- Type: stringFormat: uuid
Shorthand
filter[product_id]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.
- filter[ensemble
_id] Shorthand
filter[ensemble_id]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.- Type: stringFormat: uuid
Shorthand
filter[ensemble_id]=valuemeans equals. Operators: equals, does_not_equal, is_empty, is_not_empty.
- filter[created
_time] Shorthand
filter[created_time]=valuemeans equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.- Type: stringFormat: date-time
Shorthand
filter[created_time]=valuemeans equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.
- filter[last
_edited _time] Shorthand
filter[last_edited_time]=valuemeans equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.- Type: stringFormat: date-time
Shorthand
filter[last_edited_time]=valuemeans equals. Operators: equals, before, after, on_or_before, on_or_after, is_empty, is_not_empty.
Responses
- application/json
- application/json
- application/json
- application/json
curl 'https://api.hireorpheus.com/api/v1/prices?limit=50&offset=0&sort=order%2Cunit_amount' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"data": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"label": null,
"status": "active",
"order": null,
"lookup_key": null,
"billing_scheme": "per_unit",
"unit_amount": null,
"currency": null,
"tiers": null,
"tiers_mode": "graduated",
"product_id": null,
"ensemble_id": null,
"created_time": "2026-10-14T08:02:53.595Z",
"last_edited_time": "2026-10-14T08:02:53.595Z"
}
],
"meta": {
"total": 1,
"limit": 1,
"offset": 1
}
}