Skip to main content
GET
/
v2
/
subscriptions
/
transitions
/
{id}
Get subscription transition
curl --request GET \
  --url https://api.hyperline.co/v2/subscriptions/transitions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "customer_id": "<string>",
  "base_subscription_id": "<string>",
  "source_subscription_id": "<string>",
  "target_subscription_id": "<string>",
  "status": "scheduled",
  "transitioned_at": "2023-12-25",
  "name": "<string>",
  "transition_date": "2023-12-25",
  "application_schedule": "immediately",
  "billing_cycle_transition_method": "keep_current_billing_cycle",
  "calculation_method": "do_not_charge"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Response

​
id
string
required

The unique identifier of the subscription transition

​
customer_id
string
required

The ID of the customer associated with the transition

​
base_subscription_id
string
required

The ID of the original subscription from which this transition is derived. It references the last active version of the subscription.

​
source_subscription_id
string
required

The ID of the subscription to transition from

​
target_subscription_id
string | null
required

The ID of the subscription to transition to

​
status
enum<string>
required

The current status of the subscription transition. Possible values are 'scheduled', 'completed', 'failed', and 'draft'.

Available options:
scheduled,
completed,
failed,
draft,
cancelled,
pending_quote_signature
​
transitioned_at
string<date> | null
required

The date and time when the transition was completed. Null if the transition is not yet completed. UTC date time string in the ISO 8601 format.

​
name
string | null
required

An optional name for the transition

​
transition_date
string<date> | null
required

The date at which the transition should occur. Only applicable if the application schedule is 'scheduled'. UTC date time string in the ISO 8601 format.

​
application_schedule
enum<string>
required

Whether the transition should be applied 'immediately' or 'scheduled' for a future date.

Available options:
immediately,
scheduled,
next_renewal,
quote_signature,
scheduled_after_quote_signature
​
billing_cycle_transition_method
enum<string> | null
required

The billing cycle transition method to use. 'keep_current_billing_cycle' will keep the current billing cycle dates if possible. 'align_to_new_billing_cycle' will align the billing cycle to the transition date.

Available options:
keep_current_billing_cycle,
align_to_new_billing_cycle
​
calculation_method
enum<string> | null
required

The calculation method to use for the transition. 'do_not_charge' will not generate any transition invoice. 'pro_rata' will generate a prorated invoice for the remaining period.

Available options:
do_not_charge,
pro_rata