Get subscription
Get an existing customers subscription.
PATH:
/v1/clients/{clientId}/subscriptions/{subscriptionId}
PATH PARAMETERS:
clientId required
|
integer
Your assigned |
subscriptionId required
|
string
Id of the subscription to retrieve. |
HYPERMEDIA CONTROLS:
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 |
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}
Response samples
200400401403404500- {
- "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"
- {
- "type": "string",
- "category": "string",
- "title": "string",
- "message": "string"