Terminate subscription
Terminate a subscription. By terminating the subscription, it will be closed immediately.
PATH:
/v1/clients/{clientId}/subscriptions/{subscriptionId}/termination
PATH PARAMETERS:
clientId required
|
integer
Your assigned |
subscriptionId required
|
string
Id of the subscription to retrieve. |
HYPERMEDIA CONTROL
AVAILABLE IN:
-
Get subscription
-
Start subscription
-
Cancel subscription
-
Uncancel subscription
-
Terminate subscription
REQUEST BODY SCHEMA:
initiatedAt |
string date
The date at which the termination was initiated. Can be backdated up to and included 14 number of days. |
RESPONSES:
RESPONSE SCHEMA:
id |
string
Id of the subscription. |
||||||
status |
string Enum: NOT_STARTED ACTIVE CLOSING CLOSED PAUSED
no description in swagger file |
||||||
createdAt |
string date-time
When this subscription was created. |
||||||
updatedAt |
string date-time
When this subscription was updated. |
||||||
customerNumber |
string <= 100 characters
Id of the customer the subscription is assigned to. |
||||||
subscriptionProductId |
string <= 100 characters
Id of the subscription product used in this subscription. |
||||||
array of metadata
no description in swagger file |
|||||||
Array () [
] |
|||||||
active object
Timespan of when the subscription is active. |
|||||||
|
|||||||
object of closeDetails
Details about how the subscription has been canceled. Only visible when a subscription has been canceled. |
|||||||
|
|||||||
object of billingDetails
Billing details. |
|||||||
|
|||||||
object of currentPeriod
Timespan of the current period of the subscription. |
|||||||
|
|||||||
object of commitment
Commitment information. Only set if the subscription has commitment agreement. |
|||||||
|
|||||||
array of _links
List of hypermedia links related to this resource. |
|||||||
Array () [
] |
RESPONSE SCHEMA:
undefinedRESPONSE SCHEMA:
type |
string
The type of error that is carried within this response. The value of this type is an URI that can be dereferenced for a human-readable explanation of the error type. |
category |
string Enum: BUSINESS_ERROR TECHNICAL_ERROR
Category of the error, used primarily to determine whether the same request should be retried or not. Possible values:
|
title |
string
A short, human-readable summary of the problem. |
message |
string
A short, human-readable summary of the problem. Identical to |
RESPONSE SCHEMA:
type |
string
The type of error that is carried within this response. The value of this type is an URI that can be dereferenced for a human-readable explanation of the error type. |
category |
string Enum: BUSINESS_ERROR TECHNICAL_ERROR
Category of the error, used primarily to determine whether the same request should be retried or not. Possible values:
|
title |
string
A short, human-readable summary of the problem. |
message |
string
A short, human-readable summary of the problem. Identical to |
RESPONSE SCHEMA:
type |
string
The type of error that is carried within this response. The value of this type is an URI that can be dereferenced for a human-readable explanation of the error type. |
category |
string Enum: BUSINESS_ERROR TECHNICAL_ERROR
Category of the error, used primarily to determine whether the same request should be retried or not. Possible values:
|
title |
string
A short, human-readable summary of the problem. |
message |
string
A short, human-readable summary of the problem. Identical to |
Path
/v1/clients/{clientId}/subscriptions/{subscriptionId}/termination
Request samples
- {
- "initiatedAt": "string"
- }
Response samples
200400401403500- {
- "customerNumber": "string",
- "subscriptionProductId": "string",
- "metadata": [ ... ],
- "active": { ... },
- "closeDetails": X,
- "billingDetails": X,
- "currentPeriod": X,
- "commitment": X,
- "_links": [ ... ]
- {
- "type": "string",
- "category": "string",
- "title": "string",
- "message": "string"
- {
- "type": "string",
- "category": "string",
- "title": "string",
- "message": "string"
- {
- "type": "string",
- "category": "string",
- "title": "string",
- "message": "string"