Store APIsSubscriptions
Get upcoming invoice
Previews the next charge for a subscription — base + projected usage + MoR tax — matching what the renewal will bill. Requires the SUBSCRIPTIONS_READ scope.
AuthorizationBearer <token>
Bearer token authentication. Pass the secret directly in the Authorization header. Token secrets start with sk_.
In: header
Path Parameters
storeId*string
Length
12 <= length <= 48subscriptionId*string
Length
12 <= length <= 48Header Parameters
idempotency-key?string
Length
8 <= length <= 32Response Body
application/json
application/json
curl -X GET "https://example.com/stores/stringstring/subscriptions/stringstring/upcoming-invoice"{ "ok": true, "data": { "subscriptionId": "sub_abc123", "status": "ACTIVE", "currency": "USD", "periodStart": "2026-05-14T12:34:56.000Z", "periodEnd": "2026-06-14T12:34:56.000Z", "nextChargeAt": "2026-06-14T12:34:56.000Z", "isUsageBased": false, "baseAmount": 1999, "usageAmount": 0, "subtotal": 1999, "taxAmount": 0, "total": 1999, "lineItems": [ { "description": "Subscription base", "amount": 1999 } ] }}