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" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "X-Currency: RON"

Response (200):

{
  "items": [
    {
      "id": "sub-001",
      "status": "ACTIVE",
      "amount": 2999,
      "currency": "RON",
      "interval": "month",
      "customerEmail": "[email protected]",
      "currentPeriodStart": "2026-02-15T00:00:00.000Z",
      "currentPeriodEnd": "2026-03-15T00:00:00.000Z",
      "cancelAtPeriodEnd": false,
      "createdAt": "2026-02-15T10:00:00.000Z",
      "payLink": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "Monthly Coaching",
        "serviceType": "SERVICE"
      },
      "customer": {
        "id": "cm7v3x8h00001j1s0z0o2h4r4",
        "email": "[email protected]",
        "name": "Ion Popescu"
      }
    }
  ]
}

Subscription Statuses

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