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.

GET https://api.pandabase.io/v2/core/stores/{storeId}/subscriptions/{subscriptionId}/upcoming-invoice

Authentication

Requires a bearer token (sk_…) or an API key in the header Authorization.

Path parameters

storeId string required

(length 12–48)

subscriptionId string required

(length 12–48)

Header parameters

idempotency-key string

(length 8–32)

Response `200`

Default Response

ok enum required

(one of true)

data object required

No description.

Response `404`

Default Response

ok enum required

(one of false)

error string required

No description.

Request

curl -X GET https://api.pandabase.io/v2/core/stores/:storeId/subscriptions/:subscriptionId/upcoming-invoice

Response

{  "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      }    ]  }}