v1

latestOpenAPI 3.1.02026-07-2684271522.2 KB
Prices

Get Price

Retrieves the price with the given ID. Pass expand_product=true to inline the full Product object instead of just its ID. Resolves your own prices, and (if you belong to an organization) prices owned by a sibling account.

get/v1/prices/{id}

Path parameters

idstring required
Example:fprice_01J9XR8M3K7VZ8N2YB4WJ6T0RA

Query parameters

expand_productboolean nullable

If true, expands the product object in the response.

If true, expands the product object in the response.

Response

An envelope wrapping a single price object.

Example response

{
  "price": {
    "price_id": "fprice_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "owner_partner_id": "facct_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "description": "Premium SPF 50 mineral sunscreen",
    "unit_amount": 0,
    "recurring": {},
    "active": false,
    "product": "fprod_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
    "created_at": "2026-06-15T14:30:00Z",
    "type": "one_time",
    "metadata": {
      "order_id": "8842",
      "channel": "shopify"
    },
    "hsa_fsa_eligibility": "not_eligible",
    "test_mode": false
  }
}