v1

latestOpenAPI 3.1.0MIT2026-07-243952451019.0 KB

Products::Price

List Prices

List all prices for a given product. This will include all prices for all variants of the product. You can also filter by variant_id to get prices for a specific variant.

get/products/{product_id}/prices

Path parameters

product_idinteger required

Query parameters

afterstring

ID of item after which the collection should be returned. More examples and info about pagination in our guides.

sort_order'asc' | 'desc'

Sort order of a list response. Use 'desc' to reverse the default 'asc' (ascending) sort order. Examples in our guides.

sort_property'id' | 'updated_at'

Sort property of a list response. The default is id and thus the created_at order. If you sort by other properties, we additionally sort by id implicitly as a secondary sort property, so that you can rely on the sort order to be deterministic even if the main sort property ends up with the same values.

idstring

A comma-separated list of price IDs to filter by.

variant_idstring

A comma-separated list of variant IDs to filter by.

visibletrue | false

Filter prices by visibility in the online store.

archivedtrue | false

Filter prices by archived state.

Filter by available properties in query params, like this: api/v2/resources?filter[id]=value&filter[another_property]=value1,value2. Check our Filtering guide for examples and all about filtering here.

{
  "id": "1,2,3",
  "variant_id": "1,2,3",
  "visible": true,
  "archived": true
}

Response

idinteger

public_idstring nullable

Price public ID

variant_idinteger nullable

Variant

namestring nullable

Name

amountstring

Amount

coststring nullable

Cost

currencystring

Currency

durationstring

Duration

intervalstring

Interval

trial_intervalstring

Trial interval

trial_durationstring

Trial duration

trial_amountstring

Trial Amount

setup_amountstring nullable

Setup amount

self_cancelboolean nullable

Customer can cancel

self_upgradeboolean nullable

Customer can upgrade

self_downgradeboolean nullable

Customer can downgrade

self_reactivateboolean nullable

Customer can reactivate

interval_countstring

Interval count

payment_type'one_time' | 'subscription' | 'payment_plan' nullable

Defaults to 'one_time' if left blank

visibleboolean nullable

Visible

compare_at_amountstring nullable

Compare at amount

keystring nullable

Key

archivedboolean nullable

Archived

created_atstring date-time nullable

Added

updated_atstring date-time nullable

Updated

Example response

[
  {
    "id": 14,
    "public_id": "WpEGzF",
    "variant_id": 14,
    "name": "Example Price",
    "amount": "100.00",
    "cost": "0.00",
    "currency": "USD",
    "duration": null,
    "interval": null,
    "trial_interval": null,
    "trial_duration": null,
    "trial_amount": "0.00",
    "setup_amount": null,
    "self_cancel": true,
    "self_upgrade": true,
    "self_downgrade": true,
    "self_reactivate": true,
    "interval_count": null,
    "payment_type": "one_time",
    "visible": true,
    "compare_at_amount": null,
    "key": null,
    "archived": false,
    "created_at": "2025-01-01T00:00:00.000Z",
    "updated_at": "2025-01-01T00:00:00.000Z"
  }
]