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",
  "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"
}

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
​
billingInterval
string
required
​
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.