riverty logo

Docs

Cancel Subscription

Cancel a subscription within the Terms and conditions given by the subscription product.

Path

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

Request Parameters

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

Request Body

application/json

initiatedAt
required
string
yyyy-MM-dd
The date of which the cancellation was initiated. Can be backdated up to 14 days.
aggregatedInvoicing
boolean
Optional. Aggregates remaining subscription periods into a single invoice. Not applicable for non-commitment subscriptions.

Responses

Successful RequestUnsuccessful Request, Missing/Incorrect 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-10-27"
 },
 "status": "CLOSING",
 "closeDetails": {
  "canceledByClient": true,
  "canceledByBillingPartner": false,
  "terminatedByClient": false
 },
 "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"
  }
 ]
}