Easy Labs
APIBillingProduct

Get a product by ID

Retrieve a product by its ID. `include=prices` expands `prices` from id-only to full price rows.

GET
/v1/api/products/{id}

Authorization

apiKey
x-easy-api-key<token>

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

id*string
Length1 <= length

Query Parameters

include?string
Value in"prices"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://loading/v1/api/products/string"
{
  "success": true,
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "prod_abc123",
    "name": "Premium Widget",
    "description": "A high-quality widget",
    "active": true,
    "metadata": {},
    "image_url": "https://example.com/widget.png",
    "default_price_id": "price_abc123",
    "created_at": "2026-01-01T00:00:00.000Z"
  }
}
{
  "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
  }
}

Get a product price by ID

Retrieve a product price by its ID. The response embeds the parent product's `default_price_id` (under `products`) and a precomputed `is_default` boolean.

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`).