Developers
API and webhooks
Connect subscriptions to your warehouse, CRM, ERP or data stack.
REST API
A small, stable, versioned API for reading subscription data. It's deliberately separate from the dashboard's internal endpoints, so your integration doesn't break when we rearrange a screen.
| Endpoint | Returns |
|---|---|
GET /v1/subscriptions | Subscriptions, filterable by status, with cursor pagination |
GET /v1/subscriptions/:id | One subscription and its charges |
GET /v1/orders | Orders created by subscriptions |
Authenticate with an API key created in the app under API & integrations:
curl https://app.supersubscriptions.in/api/v1/subscriptions?status=ACTIVE \
-H "Authorization: Bearer sk_live_…" Design choices worth knowing
- Read-only. Every change a subscription can undergo already has a path that enforces its rules; a second way in would mean duplicating or bypassing them.
- Cursor pagination, not offsets — a page that shifts while you walk it would silently skip rows.
- Money carries its currency — an amount is never a bare number.
- Keys are hashed, never stored, and shown to you once.
- Every read is recorded in the audit log against the key that made it.
Webhooks
Register your own endpoints in the app to be told when a subscription changes. Each delivery is signed with a secret so your endpoint can verify it came from us.