Subscriptions
API ReferenceSubscriptionsList Subscriptions
List Subscriptions
List your subscriptions, on all your business profiles or on one.
GET /subscriptions/list
Headers
| Header | Type | Required | Description |
|---|---|---|---|
api-key | string | Yes | Your secret API key. |
X-Profile-Id | string | No | List only this profile's subscriptions. Leave it out to list across all your profiles, as List Payments does. |
A platform account sees its own subscriptions and those of its connected merchants. A connected merchant sees only its own.
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | integer | No | 10 | Number of subscriptions to return. |
offset | integer | No | 0 | Number of subscriptions to skip. |
Request Example
curl 'https://api.moonlinkpay.com/subscriptions/list?limit=10&offset=0' \ -H "api-key: snd_YOUR_API_KEY"Response
An array of subscriptions, with the same fields as Retrieve Subscription except client_secret, which is never included in a list.
[{ "id": "sub_YZQbEYEnzrjzBorzniG3", "merchant_reference_id": "order_1001", "status": "active", "customer_id": "cus_jane_42", "amount": 1500, "currency": "USD", "billing_cycle_count": 0, "next_billing_at": "2026-12-03T18:01:10.526Z", "cancel_at_period_end": false}]