Docs

Get All Subscription Pauses

Get all subscription pauses filtered by subscription id.

Path

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

Request Parameters

clientId

required

integer

Your assigned `ClientId`.

subscriptionId

required

string

Id of the subscription to retrieve.

Responses

type

required

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

required

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: * `BUSINESS_ERROR` - A business error occured. This request should *not* be retried without modification * `TECHNICAL_ERROR` - A temporary, technical error occurred. the request *should* be retried after a back-off period.

title

string

A short, human-readable summary of the problem.

message

string

A short, human-readable summary of the problem. Identical to `title`.

type

required

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

required

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: * `BUSINESS_ERROR` - A business error occured. This request should *not* be retried without modification * `TECHNICAL_ERROR` - A temporary, technical error occurred. the request *should* be retried after a back-off period.

title

string

A short, human-readable summary of the problem.

message

string

A short, human-readable summary of the problem. Identical to `title`.

required

array

A list of validation failures for the request.

Successful Request

Unsuccessful Request, Incorrect/Missing Information

Request Example

    
        null

Response Example

    
        {
 "id": "pause-id-1",
 "from": "2022-10-05",
 "until": "2022-12-05",
 "description": "2 month pause"
}

Request Example

    
        null

Response Example

    
        {
 "type": "https://developer.riverty.io/errors/subscription/error-type",
 "category": "BUSINESS_ERROR",
 "title": "A description of the problem",
 "message": "A description of the problem"
}