ChargebeeAPI

List subscription ramps

Try in API Explorer

Lists the subscription ramps that match the criteria provided in the filter parameters.

Note By default, the ramps are returned sorted in descending order (latest first) by updated_at.

Sample Request

URL Format

GET https://[site].chargebee.com/api/v2/ramps

Input Parameters

include_deleted
optional, boolean, default=false

Specifies whether to include deleted resources in the response. Deleted resources are those with the deleted attribute set to true.

Caution status or effective_from filters must not be passed when include_deleted is set to true.

.

Filter Params

For operator usages, see the Pagination and Filtering section.
status[<operator>]

optional, enumerated string filter

Filter subscription ramps based on status .

Caution

  • The subscription_id filter must be passed when filtering by status.
  • status filter should not be passed when include_deleted is set to true.

Possible values are : scheduled, succeeded, failed.

Supported operators : is, in

Example → status[is] = "SCHEDULED"

Supported operators: is, in
subscription_id[<operator>]

optional, string filter

Filter subscription ramps based on subscription_id .

Caution This filter is mandatory when filtering by status or effective_from.

Supported operators : is, in

Example → subscription_id[is] = "8gsnbYfsMLds"

Supported operators: is, in
effective_from[<operator>]

optional, timestamp(UTC) in seconds filter

Filter subscription ramps based on effective_from.

Caution

  • The subscription_id filter must be passed when filtering by effective_from.
  • effective_from filter should not be passed when include_deleted is set to true.

Supported operators : after, before, on, between

Example → effective_from[after] = "1435054328"

Supported operators: after, before, on, between
updated_at[<operator>]

optional, timestamp(UTC) in seconds filter

Filter subscription ramps based on updated_at .

Tip Specify sort_by = updated_at (whether asc oor desc) for a faster response when using this filter.

Supported operators : after, before, on, between

Example → updated_at[after] = "1435052328"

Supported operators: after, before, on, between

Returns

next_offsetoptional, string, max chars=1000

This attribute is returned only if more resources are present. To fetch the next set of resources use this value for the input parameter offset.

rampRamp object

Resource object representing ramp