Customers
A customer represents a Discord user who has subscribed to or paid for something on your server at least once. Customers are derived from subscription and invoice activity.
GET /v1/customers
List customers for the server.
Tier: B · Auth: required · Idempotent: N/A
Query parameters
| Parameter | Type | Description |
|---|---|---|
active | boolean | If true, only customers with at least one active subscription. If false, only customers without any active subscription. Omit to return all customers. |
limit | integer | Page size (max 100, default 50). |
cursor | string | Pagination cursor. |
Request
curl "https://subscord.com/api/v1/customers?active=true&limit=50" \
-H "Authorization: Bearer ssk_live_..."Response — 200 OK
{
"data": [
{
"discordUserId": "987654321098765432",
"username": "johndoe",
"isActive": true,
"totalPaid": 4995,
"currency": "USD",
"memberSince": "2025-08-12T10:32:01.000Z",
"resubscribedCount": 5
}
],
"nextCursor": "eyJjdXN0b21lcklkIjoiOTg3NjU0..."
}Performance note. Customer listing aggregates subscription and invoice data per customer. Prefer narrow filters (
active=true) and reasonable page sizes — and cache the result in your system if you list frequently.
GET /v1/customers/{discordUserId}
Look up a single customer by their Discord user ID.
Tier: A · Auth: required · Idempotent: N/A
Path parameters
| Parameter | Type | Description |
|---|---|---|
discordUserId | string | The Discord user ID (snowflake). |
Request
curl https://subscord.com/api/v1/customers/987654321098765432 \
-H "Authorization: Bearer ssk_live_..."Response — 200 OK
{
"discordUserId": "987654321098765432",
"username": "johndoe",
"isActive": true,
"totalPaid": 4995,
"currency": "USD",
"memberSince": "2025-08-12T10:32:01.000Z",
"resubscribedCount": 5
}Errors
| Status | Code | When |
|---|---|---|
| 400 | invalid_request | discordUserId is missing. |
| 404 | not_found | No customer with that ID is known to Subscord. |
| 404 | not_found | The user exists in Subscord but has never subscribed to or paid on this server. |
Field reference
| Field | Type | Description |
|---|---|---|
discordUserId | string | The customer's Discord user ID. |
username | string | The customer's most recently observed Discord username. |
isActive | boolean | true if the customer has at least one active subscription on this server. |
totalPaid | integer | Sum of all completed payments by this customer on this server, in minor units of currency. See Conventions. |
currency | string | ISO 4217 currency code. Defaults to "USD" if the customer has never paid. |
memberSince | string | null | UTC ISO 8601 timestamp of the customer's earliest completed payment, or null if none. |
resubscribedCount | integer | Number of completed invoices for this customer on this server. |