Skip to main content

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.
GET /products/{product_id} and GET /prices/{price_id} only accept the canonical id. If you have a provider_product_id or provider_price_id from elsewhere (a webhook payload, a provider dashboard), look the resource up by its canonical id instead — there is no lookup-by-provider-id endpoint for Products or Prices on the Partners API.

Workflow: from a product’s price reference to full price detail

A product’s current_price_id is already the canonical price ID — pass it straight to Get Price, no lookup step in between.
1

List products

Each item carries its own canonical current_price_id:
2

Fetch that price directly

No search step needed — the current_price_id from step 1 is the price_id this endpoint expects.

Workflow: from a list to one specific product

The same canonical id 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 id of the product you want — not provider_product_id — and call Get Product with it:
Get Product also returns the full prices array for that product, each with its own canonical id — usable the same way with Get Price.