Skip to main content
GET
/
v0
/
plans
/
{id}
Get
curl --request GET \
  --url https://api.paygentic.io/v0/plans/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "plan_z1a2b3c4d5e6f7g8",
  "object": "plan",
  "billingCadence": "P1M",
  "billingInterval": "monthly",
  "createdAt": "2024-02-15T12:30:00Z",
  "currency": "USD",
  "defaultTaxCode": "eservice",
  "defaultTaxRate": 10,
  "description": "Unlimited cloud storage plus real-time analytics tools",
  "invoiceDisplayName": "Data Warehouse Business",
  "merchantId": "org_h9i0j1k2l3m4n5o6",
  "name": "Business Package",
  "prices": [
    "price_x5y6z7a8b9c0d1e2"
  ],
  "productId": "prod_p7q8r9s0t1u2v3w4",
  "taxBehavior": "exclusive",
  "updatedAt": "2024-02-20T10:15: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 plan Unique identifier for a plan

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

Response

Plan details

​
id
string
required

Unique identifier for a plan

Pattern: ^plan_[a-zA-Z0-9]+$
​
object
enum<string>
required
Available options:
plan
​
billingCadence
enum<string>
default:P1M
required

ISO 8601 duration for the billing period.

Available options:
P1M,
P3M,
P1Y
​
billingInterval
string
required
deprecated

Deprecated. Human-readable billing period derived from billingCadence. Use billingCadence instead.

​
createdAt
string<date-time>
required
​
currency
string
required
​
merchantId
string
required

The merchant organization that owns this plan

Pattern: ^org_[a-zA-Z0-9]+$
​
name
string
required
​
productId
string
required

The product this plan belongs to

Pattern: ^prod_[a-zA-Z0-9]+$
​
updatedAt
string<date-time>
required
​
defaultTaxCode
string

Default tax code for plan line items. Common values: 'eservice' (electronically supplied services), 'saas' (software as a service), 'consulting', 'ebook', 'standard', 'reduced', 'exempt'. Full list available via GET /tax/codes endpoint.

​
defaultTaxRate
number

Fallback tax rate (as percentage) if automatic tax calculation is unavailable

​
deletedAt
string<date-time>
​
description
string
​
invoiceDisplayName
string
​
paymentTerm
object
​
prices
object[]
​
taxBehavior
enum<string>

Whether tax is added on top of the price (exclusive) or included in the price (inclusive)

Available options:
exclusive,
inclusive
​
walletNamespaceId
string

Unique identifier for a wallet namespace

​
renewalReminderEnabled
boolean

Whether renewal reminder emails are enabled for subscriptions using this plan

​
renewalReminderDays
integer

Number of days before renewal to send the reminder email

​
billingVersion
integer

Billing engine version. Managed by Paygentic support.

​
billingAnchor
string<date-time> | null

ISO 8601 datetime reference point for billing period alignment. Must be in the past or present at the time of creation or update. When set, all subscriptions created under this plan align their first billing period to the next recurrence of this anchor. Null means each subscription uses its own start time (hour-rounded) as the anchor.