Retrieve a subscription by ID or code.

-H "x-api-key: your_secret_key"

GET {{host}}/v1/subscriptions/{id}

Path Parameters

Field	Data Type	Required	Description
id	string	Yes	Subscription ID or code, for example `SUB_abc123`.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "id": "93ad2450-b49f-4c3f-a871-52a5455bdf62",
    "code": "SUB_abc123",
    "status": "ACTIVE",
    "paymentMethod": "card",
    "startDate": "2026-05-20T10:15:00.000Z",
    "nextPaymentDate": "2026-06-20T10:15:00.000Z",
    "retryCount": 0,
    "maxRetryCount": 3,
    "gracePeriodDays": 3
  }
}