Fetch a subscription
Get current status and full details of a subscription.
Path parameters
Subscription ID (sub_*).
Response
Subscription details.
Subscription ID. Prefix: sub_
Associated plan ID (plan_*).
Subscription lifecycle status. created→authenticated (mandate authorized)→active→completed/cancelled/expired. pending=charge retry scheduled; halted=multiple failures; paused=temporarily stopped.
Unix timestamp of current billing cycle start.
Unix timestamp of current billing cycle end.
Unix timestamp when subscription ended (cancelled/completed/expired).
Number of plan units billed per cycle.
Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.
Unix timestamp of next scheduled charge attempt.
Unix timestamp of first charge. Defaults to subscription creation time.
Unix timestamp after which no more charges will be attempted.
Number of mandate authorization attempts.
Total billing cycles. 0 = indefinite.
Number of billing cycles successfully charged.
Remaining billing cycles.
1 = Razorpay sends SMS/email notifications to customer on each charge.
Mandate authorization URL. Must be sent to the customer to activate the subscription.
True if a plan/quantity change is scheduled for the next cycle.
When scheduled changes take effect.
Source that created the subscription (e.g., api, dashboard).
Offer/coupon applied to the subscription.
Unix timestamp by which the customer must authorize the mandate.