Pine LabsDOCS

Get subscription details for SBMD enabled subscription

GET/ps/public/subscriptions/sbmd/{reserve_pay_sub_id}

Fetch Reserved Pay details for a customer

Requires Bearer token. Get token →

Path Parameters

FieldDetails
reserve_pay_sub_id
stringrequired

Unique identifier for the subscription.

Constraints
Maximum length: 50 characters

Header Parameters

FieldDetails
Request-Timestamp
stringdate-time

ISO 8601 UTC timestamp of the request. Used for idempotency and audit.

Request-ID
string

Use a global unique identifier [GUID] for the request.

Constraints
Minimum length: 1 characterMaximum length: 50 characters

Response

FieldDetails
subscription_id
string

Unique identifier for the created subscription

order_id
string

order_id for the created order

customer_id
string

customer_id passed

status
string

Current status of the subscription after creation

start_date
stringdate-time

Subscription start timestamp

end_date
stringdate-time

Subscription end timestamp

currency
string
total_blocked_amount
integerint64

Total amount blocked for the subscription (in smallest currency unit, e.g., paise)

debited_amount
integerint64

Amount already debited from the subscription (in smallest currency unit, e.g., paise)

remaining_balance
integerint64

Amount still available in the subscription (in smallest currency unit, e.g., paise)

Status Codes

200Success
400Bad Request
500Internal Server Error
Run
Request
curl --request GET \
  --url https://pluraluat.v2.pinepg.in/ps/public/subscriptions/sbmd/%7Breserve_pay_sub_id%7D \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z'
200 OK
{
  "subscription_id": "v1-sub-260601221059-aa-G3KP2L",
  "order_id": "v1-260601221059-aa-29gUE3",
  "customer_id": "cust-v1-260601210124-aa-NG6Pt3",
  "status": "ACTIVE",
  "start_date": "2026-06-01T22:10:59.591656Z",
  "end_date": "2026-06-15T22:10:59.59166Z",
  "currency": "INR",
  "total_blocked_amount": 1100,
  "debited_amount": 600,
  "remaining_balance": 500
}