Get subscription

GET/v1/billing/subscription🔑 API key required

Your current subscription, its status/period, recent events, and the purchasable plans.

Response fields

Field	Type	Description
`plan`	string	Your active plan (entitlements).
`subscription`	object	{ plan, status, amountUsdc, currentPeriodEnd, graceUntil, cancelAtPeriodEnd, failedAttempts } or null.
`events[]`	array	Recent lifecycle events (created/activated/renewal_*/canceled/downgraded).
`plans[]`	array	Purchasable plans with their USDC price.

← PreviousSubscribe to a plan Next →Cancel subscription

curl "https://www.quanaris.com/v1/billing/subscription" \
  -H "x-api-key: $QUANARIS_KEY"

const res = await fetch("https://www.quanaris.com/v1/billing/subscription", {,
  headers: { "x-api-key": process.env.QUANARIS_KEY }
});
const data = await res.json();

Response example

{
  "plan": "builder",
  "subscription": { "plan": "builder", "status": "active", "amountUsdc": 50, "currentPeriodEnd": "2026-07-04T…", "cancelAtPeriodEnd": false, "failedAttempts": 0 },
  "events": [ { "type": "activated", "at": "2026-06-04T…" } ],
  "plans": [ { "id": "builder", "priceUsdc": 50, "includedMints": 10 } ]
}