Two IDs, two purposes
Every product and price carries two different identifiers:Canonical ID
The
id field. Assigned by OpenLoop. This is what GET /products/{product_id} and GET /prices/{price_id} expect.Provider ID
The
provider_product_id / provider_price_id field. Assigned by the payment provider (e.g. a Stripe prod_... or price_... id). Required at checkout: POST /v0.1/checkouts/sessions takes provider_price_id (not the canonical id). It is not accepted by the single-resource lookup endpoints below, which return a 404 for it.Workflow: from a product’s price reference to full price detail
A product’scurrent_price_id is already the canonical price ID — pass it straight to Get Price, no lookup step in between.
1
List products
current_price_id:2
Fetch that price directly
current_price_id from step 1 is the price_id this endpoint expects.Workflow: from a list to one specific product
The same canonicalid that identifies a product in a list response is what GET /products/{product_id} expects.
1
List products
2
Fetch that one product's full detail
Take the canonical Get Product also returns the full
id of the product you want — not provider_product_id — and call Get Product with it:prices array for that product, each with its own canonical id — usable the same way with Get Price.
