riverty logo

Docs

Terminate Subscription

Terminate a subscription. By terminating the subscription, it will be closed immediately.

Path

PUT /v1/clients/{clientId}/subscriptions/{subscriptionId}/termination

Request Parameters

clientId
required
integer
Your assigned `ClientId`.
subscriptionId
required
string
Id of the subscription to retrieve.

Responses

Successful RequestUnsuccessful Request, Incorrect/Missing Information

Request Example

    
        {
 "initiatedAt": "2022-09-29"
}

Response Example

    
        {
 "id": "subscription-id-1",
 "customerNumber": "customer-number-1",
 "subscriptionProductId": "subscription-product-id-1",
 "metadata": [
  {
   "key": "order-id",
   "value": "a9ee9996-e941-4aa8-90b9-4b047c4afe87"
  }
 ],
 "createdAt": "2022-01-28T13:04:40.020Z",
 "active": {
  "from": "2022-09-28",
  "until": "2022-09-29"
 },
 "status": "CLOSED",
 "closeDetails": {
  "canceledByClient": false,
  "canceledByBillingPartner": false,
  "terminatedByClient": true
 },
 "billingDetails": {
  "nextBillingDate": "2022-09-30",
  "billingDayOffset": 2
 },
 "currentPeriod": {
  "start": "2022-09-28",
  "end": "2022-10-27"
 },
 "_links": [
  {
   "method": "GET",
   "href": "https://api.horizonafs.io/subscription/v1/clients/1234/subscriptions/subscription-id-1",
   "rel": "self"
  },
  {
   "method": "GET",
   "href": "https://api.horizonafs.io/subscription/v1/clients/1234/subscription-products/subscription-product-id-1",
   "rel": "subscription-product"
  },
  {
   "method": "GET",
   "href": "https://api.horizonafs.io/subscription/v1/clients/1234/subscriptions/subscription-id-1/timeline",
   "rel": "timeline"
  }
 ]
}