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. The website has its own portal at /account, but it needs a website login and reads a stripe_customer_id out of the website's own subscriptions table. A customer who subscribed through this API has neither — they never registered on the website, and their customer id lives on their api_keys row. Before this endpoint the only way for them to change a failing card was to email us, which is how a subscription is lost to an expired card rather than a decision. 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
• 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
• POST /v1/billing/upgrade-link — Prorated upgrade link (console; confirms your password)