riverty logo

Docs

Get Subscription

Get an existing customers subscription.

Path

GET /v1/clients/{clientId}/subscriptions/{subscriptionId}

Request Parameters

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

Responses

Successful RequestUnsuccessful Request, Incorrect Subscription Number

Request Example

    
        null

Response Example

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