Retrieve Plan
Retrieves the details of an existing plan.
Authorizations
A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************
Headers
Pins the request to a dated API version.
"2026-07-20"
Path Parameters
Plan ID, prefixed plan_.
Response
plan retrieved
Account that sells this plan; null for standalone invoice plans.
Whether this plan accepts local currency payments via adaptive pricing.
Recurring billing interval in days, such as 30 for monthly or 365 for annual. null for one-time plans.
Whether tax is collected on purchases of this plan.
When the plan was created, as an ISO 8601 timestamp.
Three-letter ISO currency code for this plan's prices.
usd, sgd, inr, aud, brl, cad, dkk, eur, nok, gbp, sek, chf, hkd, huf, jpy, mxn, myr, pln, czk, nzd, aed, eth, ape, cop, ron, thb, bgn, idr, dop, php, try, krw, twd, vnd, pkr, clp, uyu, ars, zar, dzd, tnd, mad, kes, kwd, jod, all, xcd, amd, bsd, bhd, bob, bam, khr, crc, xof, egp, etb, gmd, ghs, gtq, gyd, ils, jmd, mop, mga, mur, mdl, mnt, nad, ngn, mkd, omr, pyg, pen, qar, rwf, sar, rsd, lkr, tzs, ttd, uzs, rub, btc, cny, usdt, kzt, awg, whop_usd, xau "usd"
Customer-visible plan description.
Access duration in days for expiration-based plans.
Plan ID, prefixed plan_.
Initial purchase price in plan currency.
Private notes visible only to authorized team members.
Invoice this plan was generated for; null unless created for an invoice.
Active memberships through this plan, when visible to the requester.
Custom key-value pairs stored on the plan.
Payment method configuration (enabled, disabled, include_platform_defaults); null when plan uses default settings.
Billing model for this plan: renewal (recurring) or one_time (single payment).
renewal, one_time "renewal"
Product this plan belongs to; null for standalone plans.
URL where customers can purchase this plan directly.
Sales method for this plan, such as buy_now or waitlist.
buy_now, waitlist "buy_now"
Recurring price charged every billing period.
Installment payments required before the subscription pauses.
Units available for purchase, when visible to the requester.
How tax is handled for this plan.
inclusive, exclusive, unspecified "inclusive"
3D Secure behavior for this plan; null inherits account default.
mandate_challenge, frictionless, null "mandate_challenge"
Plan display name shown to customers.
Free trial days before the first renewal charge. null if no trial is configured or the user has already used a trial for this plan.
Whether the plan has unlimited stock.
When the plan was last updated, as an ISO 8601 timestamp.
Whether the plan is visible to customers or hidden from public view.
visible, hidden, archived, quick_link "visible"

