GET /v1/billing/portal

Returns a short-lived Stripe billing portal URL for this key's subscription: update the card, download invoices, see what the next charge will be. THE API KEY IS THE IDENTITY. No website account or separate login is needed: the key that holds the subscription opens its portal, so a customer who subscribed through the API can change a failing card, pull invoices or cancel without contacting us. The returned URL is a BEARER link: anyone holding it can manage the subscription until it expires. It is deliberately never logged, and callers should not paste it anywhere.

Request

curl 'https://api.puntersedge.online/v1/billing/portal' \
  -H 'X-API-Key: YOUR_KEY'

Parameters

This endpoint takes no parameters beyond authentication.

Responses

Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Example response

200 application/json — this call costs 0 credits. Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

{
  "url": "https://billing.stripe.com/p/session/live_YWNjdF8xUHZ2c3Bsb0N0Nnp0dGMx",
  "expires_at": 1757212800,
  "note": "Single-use and short-lived. Treat it like a password: anyone with this link can manage the subscription."
}

Related endpoints

• GET /v1/account — Your account: email, plan, password, billing and consent status
• GET /v1/account/events — Your account's change history
• POST /v1/account/marketing — Turn promotional emails on or off for your account
• POST /v1/account/password — Set or change your account password
• GET /v1/billing/overage — Overage: state, rate and ceiling
• POST /v1/billing/overage — Switch overage on or off
• POST /v1/billing/portal — Billing portal link (console; confirms your password)
• GET /v1/billing/upgrade-link — A signed link to your prorated upgrade page