API Reference

The Subscord Seller API lets you read your subscription data and perform a focused set of mutations from your own systems, such as building dashboards, syncing data into a CRM, automating operational workflows, or integrating Subscord into a larger product.

Requires Max. The Seller API is only available to servers on the Max plan. Servers on Free or Pro cannot use API keys, and requests from lower plans return 403 plan_required.

Base URL

https://subscord.com/api/v1

All endpoints are versioned under /v1. Breaking changes will ship under a new version prefix.

Content type

All requests with a body must send Content-Type: application/json.
All responses are application/json; charset=utf-8.
Maximum request body size is 16 KB.

Quickstart

1. Create an API key

In your Subscord dashboard, go to Settings → API Keys and click Create API Key. Copy the key (ssk_live_...) — you will only see it once.

See Authentication for full details on creating, rolling, and revoking keys.

2. Make your first request

curl https://subscord.com/api/v1/guild \
  -H "Authorization: Bearer ssk_live_your_key_here"

Example response:

{
  "id": "123456789012345678",
  "name": "My Server",
  "store": {
    "name": "My Store",
    "description": "Premium memberships",
    "url": "https://subscord.com/store/my-server"
  },
  "paymentMethods": {
    "stripe": true,
    "crypto": false
  }
}

3. Read your subscriptions

curl "https://subscord.com/api/v1/subscriptions?active=true&limit=10" \
  -H "Authorization: Bearer ssk_live_your_key_here"

What the API supports

Resource	Read	Mutations
Guild	Yes	—
Products	List, detail	—
Customers	List, detail	—
Subscriptions	List, detail	Grant, extend, cancel
Invoices	List, detail	—
Discounts	List, detail	Toggle active
Stats	Overview, time series	—

What the API does not do

These are deliberate omissions, not roadmap items. Open a request if you need any of them:

Webhooks management — webhooks are configured in the dashboard. See the Webhooks guide for receiving events.
Affiliate management.
Discount validation at checkout — discounts are evaluated server-side during a real purchase.
Subscription deletion — only cancellation is supported.
Discord-side actions — granting Discord roles, syncing members, sending DMs. Anything that hits the Discord API directly is intentionally not exposed here.
Product catalog mutations — products and product options are managed in the dashboard.
Refunds and Stripe payouts.

Read the basics first

Before integrating, please read these short pages — they apply to every endpoint:

Authentication — how to use API keys
Conventions — money, timestamps, IDs
Errors — error format and codes
Rate Limits — per-tier limits and headers
Idempotency — required for all mutations
Pagination — cursor-based, no totals

Webhooks Authentication