Prices

Get Price

Retrieve a specific price by its ID. Includes full pricing configuration (pricingData), associated plan, currency, and metadata. Verifies merchant ownership through the associated plan.

GET
/prices/{priceId}

Authorization

bearerAuth
AuthorizationBearer <token>

Use your secret API key as the bearer token

In: header

Path Parameters

priceId*string

Price ID (must start with prc_)

Match^prc_[a-z0-9]+$

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.getlumen.dev/v1/prices/prc_01hrwzqrz4ytkwv07syv8k7g3z"
{
  "price": {
    "id": "prc_01hrwzqrz4ytkwv07syv8k7g3z",
    "planId": "pln_01hrx123",
    "merchantId": "mrc_01hptv3p6xj173pfv96pxd5pke",
    "currency": "USD",
    "pricingData": {
      "type": "recurring",
      "interval": "month",
      "intervalCount": 1,
      "amountCents": 2999
    },
    "isOverridePrice": false,
    "clonedFromPriceId": null,
    "createdAt": "2024-12-01T10:00:00.000Z",
    "deletedAt": null
  }
}
{
  "error": "Unauthorized access to price"
}
{
  "error": "Price not found or access denied"
}
{
  "error": "Failed to fetch price"
}