Skip to main content
POST
Preview the initial or renewal invoice for a hypothetical subscription.

Query Parameters

asOf
string | null
default:now

Set to "renewal" to see the renewal invoice. Defaults to "now".

Body

application/json

The subscription to preview

Uid
string | null
Maximum string length: 10
_objectType
string | null
ActivityEventData
unknown
BillingRenewalTerm
enum<integer>

1 - Monthly, 2 - Yearly, 3 - Quarterly, 4 - One Time

Available options:
1,
2,
3,
4
Required range: 1 <= x <= 4
Account
Account · object | null

Circular reference to Account (not expanded here).

Plan
object | null
Example:
Quantity
integer<int32> | null
StartDate
string<date-time>
EndDate
string<date-time> | null
ExpirationDate
string<date-time> | null
RenewalDate
string<date-time> | null
NewRequiredQuantity
integer<int32> | null
IsPlanUpgradeRequired
boolean
PlanUpgradeRequiredMessage
string | null
SubscriptionAddOns
object[] | null
DiscountCouponSubscriptions
object[] | null
DiscountCode
string | null
DiscountCouponExpirationDate
string<date-time> | null
LatestInvoice
object | null
Example:
Rate
number<decimal> | null

Response

200 - application/json
Created
string<date-time>
required
read-only
Minimum string length: 1
Updated
string<date-time>
required
read-only
Minimum string length: 1
Uid
string | null
Maximum string length: 10
_objectType
string | null
ActivityEventData
unknown
InvoiceDate
string<date-time>
PaymentReminderSentDate
string<date-time> | null
Number
integer<int32>
BillingInvoiceStatus
enum<integer>

1 - Unpaid, 2 - Paid, 3 - Partial, 4 - Uncollected, 5 - Refunded, 6 - Uncollectible, 7 - Processing

Available options:
1,
2,
3,
4,
5,
6,
7
Subscription
Subscription · object | null

Circular reference to Subscription (not expanded here).

Amount
number<decimal>
AmountOutstanding
number<decimal>
InvoiceLineItems
object[] | null
IsUserGenerated
boolean
StripeTaxCalculationId
string | null
Maximum string length: 50
StripeTaxBehavior
string | null
Maximum string length: 10
AmountCredit
number<decimal>
AmountDiscount
number<decimal>
AmountPaid
number<decimal>
AmountRefunded
number<decimal>
AmountSubtotal
number<decimal>
AmountTax
number<decimal>
AmountTaxRefunded
number<decimal>
IsTaxable
boolean
HasPaymentGatewayTransactions
boolean
StripePaymentTransactionIds
string | null
StripeRefundTransactionIds
string | null
StripeTaxRefundTransactionIds
string | null