Skip to main content
GET
/
v0
/
prices
/
{id}
Get
curl --request GET \
  --url https://api.paygentic.io/v0/prices/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "price_b1c2d3e4f5g6h7i8",
  "object": "price",
  "billableMetricId": "bm_j9k0l1m2n3o4p5q6",
  "createdAt": "2024-02-10T13:45:00Z",
  "currency": "USD",
  "description": "Tiered pricing for storage capacity",
  "invoiceDisplayName": "Storage Usage (GB)",
  "model": "volume",
  "paymentTerm": "in_arrears",
  "properties": {
    "maxPrice": "0.25",
    "minPrice": "0.05"
  },
  "unitAmount": "50000000000",
  "updatedAt": "2024-02-25T09:30:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.paygentic.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key authentication

Path Parameters

​
id
string
required

The unique identifier of the price Unique identifier for a price

Pattern: ^price_[a-zA-Z0-9]+$

Response

Price details

​
id
string
required

Unique identifier for a price

Pattern: ^price_[a-zA-Z0-9]+$
​
object
enum<string>
default:price
required
Available options:
price
​
createdAt
string<date-time>
required
​
invoiceDisplayName
string
required
​
paymentTerm
enum<string>
required
Available options:
instant,
in_arrears,
in_advance
​
properties
object
required

Standard pricing model

​
updatedAt
string<date-time>
required
​
quantity
integer
required

Quantity for invoice line items. Total per period = quantity × unitPrice. Only supported for fee prices; metered prices derive quantity from usage. Defaults to 1.

Required range: x >= 1
​
billableMetricId
string

Unique identifier for a billable metric

Pattern: ^bm_[a-zA-Z0-9]+$
​
feeId
string

The unique identifier for the fee referred to by this price. Present when price is linked to a fee.

Pattern: ^fee_[a-zA-Z0-9]+$
​
billingCadence
string | null

ISO 8601 duration. 'P0D' for one-time, 'P1M' for monthly, 'P1Y' for yearly. Required for fees, optional for billable metrics. Defaults to plan's billingCadence if not specified.

​
model
enum<string>
Available options:
standard,
dynamic,
volume,
percentage
​
features
object[]

Features associated with this price

​
grantDiscountEnabled
boolean
default:false

When true, grants applied to a subscription will discount usage charged by this price. Only supported for standard metered prices.