List live references to a product price
List every live object that still charges off this price: items on payment links in state ACTIVE/DRAFT (`payment_link`), items on subscriptions whose status is not canceled/incomplete_expired (`subscription`), and legacy Finix subscription plans (`subscription_plan`). Historical purchases are excluded (amounts are snapshotted at charge time). A price with one or more references cannot be archived — repoint each reference first. `item_id` is the join-row id used for repointing (payment_link_items.id / subscription_items.id — the latter goes in PATCH /subscriptions/:id `remove_items`).
Authorization
apiKey Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.
In: header
Path Parameters
1 <= lengthResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://loading/v1/api/product-prices/string/references"{
"success": true,
"timestamp": "2026-02-06T12:00:00.000Z",
"message": "Product price references retrieved successfully",
"data": {
"references": [
{
"type": "payment_link",
"id": "pl_abc123",
"name": "Premium Widget Payment",
"item_id": "pli_abc123",
"current_price_id": "price_abc123"
},
{
"type": "subscription",
"id": "sub_abc123",
"name": "Subscription sub_abc1",
"item_id": "si_abc123",
"current_price_id": "price_abc123"
}
]
}
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}{
"success": false,
"timestamp": "2019-08-24T14:15:22Z",
"error": {
"code": "string",
"message": "string",
"details": null
}
}