Subscriptions

View subscriptions tied to your paylinks. Requires authentication.

GET /subscriptions

List subscriptions for the seller (subscriptions on your paylinks).

curl "https://api.paylinks.ro/api/v1/subscriptions?limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Currency: RON"

Query Parameters:

Parameter	Type	Default	Description
limit	integer	20	Items per page (max 100)
cursor	string	—	Pagination cursor

Response (200):

{
  "data": [
    {
      "id": "sub-001",
      "payLinkId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "customerEmail": "[email protected]",
      "status": "ACTIVE",
      "currentPeriodEnd": "2026-03-15T00:00:00.000Z",
      "amount": 2999,
      "currency": "RON",
      "interval": "month",
      "createdAt": "2026-02-15T10:00:00.000Z"
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

Subscription Statuses

Status	Description
ACTIVE	Subscription is active and billing
CANCELED	Canceled, active until period end
PAST_DUE	Payment failed, retry in progress