---
title: "Renew Subscription"
method: POST
path: "/subscription/renewsubscription"
tags: ["Subscription API"]
---

# Renew Subscription

`POST /subscription/renewsubscription`

Triggers an instant renewal of a subscription. If the renewal payment can be processed with the current payment details, then the subscription is renewed, and the customer receives an email confirmation with the delivery details. If the renewal payment cannot be processed with the current payment details, or if an offline payment is required, then the customer receives an email with payment instructions. You can use this API if a B2B customer has budget left at the end of the year, and they want to renew their auto-renewal subscription before the end of the year.<br />For XML examples and schemas, see the [Additional Examples - Renew Subscription](https://dev.cleverbridge.com/page/additional-examples-renew-subscription).

## Headers

- `Accept` 'application/json' | 'application/xml'
- `Content-Type` 'application/json' | 'application/xml'

## Request body

- CleverbridgeBackEndRestApiSubscriptionClassesRenewSubscriptionRequest
  - `SubscriptionId` string, required — Unique ID of the subscription, with or without an initial 'S'.
  - `ResetBillingInterval` boolean — Set to <code>true</code> to immediately start the new billing interval. Can be used when the customer has reached their data limit. For more information, see [Renew a Subscription Early at Full Price](https://dev.cleverbridge.com/docs/retain-phase-renew-a-data-limited-subscription-early-at-full-price).

## Response `200`

OK

- CleverbridgeBackEndRestApiSubscriptionClassesRenewSubscriptionResponse
  - `ContinueUrl` string — URL of web page with transaction details or payment instructions.
  - `NextBillingDate` string, date-time — Next billing date according to [RFC3339](https://www.rfc-editor.org/info/rfc3339). Specified in UTC.
  - `TransactionStatus` string — Status of the renewal transaction. Possible values are <code>Success</code>, <code>Error</code>, <code>Rejected</code>, <code>Pending</code>, <code>Unknown</code>. See [Transaction Status](https://dev.cleverbridge.com/reference/purchase-status#transaction-status) for explanations to those values.
  - `ResultMessage` string — Optional result or error message.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/cleverbridge/apis/backend-rest-apis.md) · [All operations](https://skmtc.net/cleverbridge/apis/backend-rest-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleverbridge/backend-rest-apis/versions/b7007b62f4c0/schema)