logo

Retrieve a list of subscription pauses

Retrieve a list of pauses for all subscriptions.

SecuritySecretApiKey or JWT
Request
query Parameters
limit
integer [ 0 .. 1000 ]

The collection items limit.

offset
integer >= 0

The collection items offset.

filter
string

The collection items filter requires a special format. Use "," for multiple allowed values. Use ";" for multiple fields. See the filter guide for more options and examples about this format.

sort
Array of strings

The collection items sort field and order (prefix with "-" for descending sort).

Responses
200

A list of pauses was retrieved successfully.

Response Headers
Pagination-Total
integer

Total items count.

Example: 332
Pagination-Limit
integer

Items per page limit.

Example: 100
Pagination-Offset
integer

Pagination offset.

Example: 2
Response Schema: application/json
Array
subscriptionId
required
string <= 50 characters

Identifier of the paused subscription.

id
string <= 50 characters

Pause identifier.

status
string

The pause status.

Enum: "pending" "ongoing" "revoked" "finished"
pausedBy
string
Default: "customer"

Who did the pause.

Enum: "merchant" "customer"
description
string or null <= 255 characters

Pause reason description.

effectiveTime
string or null <date-time>

The date from which the service period will pause. This time should be later than now, if it is earlier then current time is taken. If omitted, it will default to the current time.

endTime
string or null <date-time>

The time when the pause ends and the subscription resumes its billing. In order to resume a subscription now, use current time or past time (will default to now). Empty endTime will result in indefinitely paused subscription.

timeRemaining
string

Time period between the pause end time and the renewal time in ISO-8601 durations format. By default, it's computed as the time between the pause and the renewal. For instance, you have a $30/month subscription and 30-day month. If you pause on day 20 of the subscription, there are 10 days unused. Therefore, the subscription would renew in 10 days after resuming. The upcoming invoice would not change the amount for invoiced period, it remains $30. There may be a billing anchor for the subscription, the renewal time after a pause shift should behave as if the renewal time moved forward with Order API (the billing anchor is ignored for that period then).

createdTime
string <date-time>

The time of resource creation (when it is posted).

updatedTime
string <date-time> (UpdatedTime)

Read-only timestamp updates when the resource is updated.

Array of objects (Self) non-empty

The links related to resource.

Array (non-empty)
href
required
string

The link URL.

rel
required
string

The link type.

Value: "self"
401

Unauthorized access, invalid credentials were used.

403

Access forbidden.

get/subscription-pauses
Request samples
Response samples
application/json
[
  • {
    }
]
➔ Next to Pause a subscription