---
title: "Subscription - Resume Subscription"
method: POST
path: "/subscriptions/{subscription_id}/resume"
tags: ["Subscriptions"]
---

# Subscription - Resume Subscription

`POST /subscriptions/{subscription_id}/resume`

Resume the subscription

## Path parameters

- `subscription_id` string, required

## Headers

- `X-Profile-Id` string, required

## Request body

- ResumeSubscriptionRequest — Request payload for resuming a subscription.
  - `resume_option` 'immediately' | 'specific_date'
  - `resume_date` string, nullable — Optional date when the subscription should be resumed (if not provided, resumes immediately)
  - `charges_handling` 'invoice_immediately' | 'add_to_unbilled_charges'
  - `unpaid_invoices_handling` 'no_action' | 'schedule_payment_collection'

## Response `200`

Subscription resumed successfully

- ResumeSubscriptionResponse — Response payload returned after successfully resuming a subscription.
  - `id` string, required — A type for subscription_id that can be used for subscription ids
  - `status` 'active' | 'created' | 'in_active' | 'pending' | 'trial' | 'paused' | 'unpaid' | 'onetime' | 'cancelled' | 'failed', required — Possible states of a subscription lifecycle. - `Created`: Subscription was created but not yet activated. - `Active`: Subscription is currently active. - `InActive`: Subscription is inactive. - `Pending`: Subscription is pending activation. - `Trial`: Subscription is in a trial period. - `Paused`: Subscription is paused. - `Unpaid`: Subscription is unpaid. - `Onetime`: Subscription is a one-time payment. - `Cancelled`: Subscription has been cancelled. - `Failed`: Subscription has failed.
  - `merchant_reference_id` string, nullable — Merchant specific Unique identifier.
  - `profile_id` string, required — A type for profile_id that can be used for business profile ids
  - `merchant_id` string, required — A type for merchant_id that can be used for merchant ids
  - `customer_id` string, required — A type for customer_id that can be used for customer ids
  - `next_billing_at` string, nullable — Date when the subscription was resumed

## Other responses

- `400` — Invalid resume data
- `404` — Subscription not found

---

[API](https://skmtc.net/hyperswitch/apis/dynamic-routing-openapi-3-0.md) · [All operations](https://skmtc.net/hyperswitch/apis/dynamic-routing-openapi-3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperswitch/dynamic-routing-openapi-3-0/versions/8fbf69ab2597/schema)