List subscribers
GET /subscribers lists subscriptions across every plan a merchant owns.
GET/subscribers?merchant_id={merchant_id}
Query
merchant_iduuidrequired
Merchant whose subscribers to list. Must be a valid UUID.
Request
curl "http://localhost:3001/subscribers?merchant_id=3f0c6a1e-..."Response 200
{
"subscribers": [
{
"id": "b2a9e4c1-...",
"customer_wallet_address": "GDQP...4N2",
"status": "active",
"next_billing_date": "2026-10-25T10:00:00Z",
"plans": { "merchant_id": "3f0c6a1e-...", "name": "Pro Monthly", "usdc_amount": 290000000 }
}
]
}A merchant with no subscribers, or a merchant_id that does not exist, returns 200 with an empty subscribers array.
Errors
| Status | When |
|---|---|
400 | merchant_id is missing or is not a valid UUID |
500 | Database error |