Get list of switchable plans

X-Api-Token

header

string

Required

API token of a manager that performs the operation (see

)

Content-Type

header

string

Required

Media type of the request. Specify the following: application/vnd.api+json

Accept

header

string

Required

Supported media types of the answer. Specify the following: application/vnd.api+json

base_url

path

string

Required

ActivePlatform URL

reseller_id

path

integer

Required

ID of the current reseller or any of its downstream resellers (see 

)

plan_id

path

integer

Required

ID of the plan for which the list of switchable plans is requested

page[size]

query

integer

Optional

Page navigation: number of elements per page. The default value is 50

page[number]

query

integer

Optional

Page navigation: page number

filter[switch_type]

query

string

Required

Filter the list of switchable plans by switch type:

• immediate_switch — plans available for the immediate switch.

• delayed_switch — plans available for the delayed switch.

data

array of objects

Response data

id

integer

ID of the plan

type

string

Data type

attributes

object

Information about the plan

created_at

string

Date and time of the plan creation

updated_at

string

Date and time when the plan was updated

status

string

Status of the plan (for the list of plans statuses, see

)

name

string

Name of the plan

description

string

Plan details description

public

bool

Indication whether the plan is available for sale:

• true — the plan is available for sale.

• false — the plan is not available for sale.

plan_class_id

integer

ID of the service term (see )

product_id

integer

ID of the product of the plan

billing_type

string

Billing type of the plan (see

)

ancestry

string

For delegated plans, consists of the list of all parent plans starting from the root plan (see

). For plans created by the reseller, is null.

reseller_id

integer

ID of the reseller

fixed_price

bool

The Fixed price option of the plan:

• true — a customer pays for the subscription and ordering additional resources the same price as it was set at the moment of the subscription order. The new price will be applied only after the subscription is renewed.

• false — the plan prices are not fixed for customers.

sku

string

SKU of the plan

singleton

bool

The Singleton option of the plan:

• true — a customer can have only one subscription to the plan.

• false — a customer can have several subscriptions to the plan.

auto_renewal

bool

Indicates the status of the Auto-renew option of the plan:

• true — the Auto-renew option is activated.

• false — the Auto-renew option is not activated.

auto_renewal_disabled

bool

Indicates the status of the Disable the Auto-renew option option of the plan:

• true — the Disable the Auto-renew option option is activated.

• false — the Disable the Auto-renew option option is not activated.

plan_class

string

Name of the service term

product_category_id

integer

ID of the product category of the plan

product_category

string

Name of the product category of the plan

product_category_public

bool

Indicates the status of the Public option of the product category:

• true — the product category is available for selling.

• false — the product category is not available for selling.

product

string

Name of the product of the plan

plan_resources

object

Resources of the plan

data

array of objects

Object data

id

integer

ID of the resource in the plan

type

string

Data type

attributes

object

Information about the resource

created_at

string

Date and time of the resource creation

updated_at

string

Date and time when the resource was updated

name

string

Name of the resource

measurable

bool

Displays whether the actual amount of the used resource is supported:

• true — the actual amount of the used resource is used for generating charges.

• false — the actual amount of the used resource is not used for generating charges.

unit_of_measure

string

Unit of measure of the resource:

• unit — the resource is measurable. The resource amount is specified.

• boolean — the resource is non-measurable. The resource amount is not required and:true — the resource is included in the plan.false — the resource is not included in the plan.

application_template_name

string

Name of the application template

included

integer

Amount of the resource included in the plan by default (included resources are part of the subscription price)

minimum

integer

Minimum amount of the resource (together with the included amount) available for ordering (see )

limit

integer

Maximum amount of the resource available for ordering. For an unlimited resource (unlimited_units = true), limit = 0

setup_fee

string

Setup fee of the resource

recurring_fee

string

Monthly recurring fee of the resource

overuse_fee

string

Overuse fee of the resource

renewal_fee

string

Renewal fee of the resource

unlimited_units

bool

Attribute of the unlimited resource:

• true — the resource is unlimited.

• false — the resource is not unlimited.

public

bool

Availability of the resource:

• true — the resource is available for ordering.

• false — the resource is not available for ordering.

status

string

Status of the resource:

• active

• inactive

• deleted

resource_id

integer

ID of the resource in the application template

priority

integer

Priority of the resource. For the main resource, priority is maximal

net_costs

object

The resource net costs

setup_fee

string

Setup fee of the resource

recurring_fee

string

Monthly recurring fee of the resource

overuse_fee

string

Overuse fee of the resource

renewal_fee

string

Renewal fee of the resource

erp

object

The recommended price (ERP) of the resource

setup_fee

string

Setup fee of the resource

recurring_fee

string

Monthly recurring fee of the resource

overuse_fee

string

Overuse fee of the resource

renewal_fee

string

Renewal fee of the resource

custom_attributes

object

Information about custom attributes of the resource

plan_resources.custom_attributes.['custom-attribute-key']

string

Value of the custom attribute of the resource

plan_periods

object

Plan periods

data

array of objects

Object data

id

integer

ID of the plan period

type

string

Data type

attributes

object

Information about the plan period

created_at

string

Date and time of the plan period creation

updated_at

string

Date and time when the plan period was updated

duration_value

integer

Duration of the plan period. For an endless plan period, duration_value = null

duration_type

string

Unit of measure of the plan period duration. For an endless plan period, duration_type = null

setup_fee

float

Setup fee of the plan for the plan period

recurring_fee

float

Monthly recurring fee of the plan for the plan period

transfer_fee

float

Transfer fee of a domain for the plan period. The transfer fee is applied if domains are available as a resource in the Service

renewal_fee

float

Renewal fee of the plan for the plan period

trial

bool

Plan period type:

• true — trial plan period.

• false — commercial plan period.

public

bool

Availability of the plan period:

• true — the plan period is available for ordering.

• false — the plan period is not available for ordering.

status

string

Status of the plan period:

• active

• deleted

description

string

Plan period details description

endless

bool

Indicator of the endless plan period:

• true — the plan period is endless (perpetual).

• false — the plan period is not endless. For the plan period duration, see duration_value and duration_type.

net_costs

object

The period net costs

setup_fee

string

Setup fee of the plan for the plan period

recurring_fee

string

Monthly recurring fee of the plan for the plan period

transfer_fee

string

Transfer fee of a domain for the plan period. The transfer fee is applied if domains are available as a resource in the service

renewal_fee

string

Renewal fee of the plan for the plan period

erp

object

The recommended price (ERP) of the plan period

setup_fee

string

Setup fee of the plan for the plan period

recurring_fee

string

Monthly recurring fee of the plan for the plan period

transfer_fee

string

Transfer fee of a domain for the plan period. The transfer fee is applied if domains are available as a resource in the service

renewal_fee

string

Renewal fee of the plan for the plan period

plan_currency

string

Currency code of the plan

available_account_types

object

Information about account types

data

array of objects

Object data

id

integer

ID of the account type

type

string

Data type

attributes

object

Information about an account type

created_at

string

Date and time of the account type creation

updated_at

string

Date and time when the account type was updated

reseller_id

integer

ID of the reseller linked to the account type

name

string

Name of the account types

ancestry

string

ID of the parent account type

default_payment_method_id

integer

ID of the default payment method (see

)

key

string

Key that is used to refer to the account type by API or a placeholder

name_pattern

string

Template of the account type name which is displayed in the platform

use_by_default

bool

Default account type:

• true — the account type is used by default.

• false — the account type is not used by default.

primary_name

string

Name of the field with the primary name of the account. For example, for the Business account type, the filed may be named as Company name

custom_attributes

object

Information about custom attributes of the plan

custom_attributes.['custom_attribute_key']

string

Value of the custom attribute of the plan

plan_class_data

object

The switch settings from the linked service term (see

)

increase_resources_immediate_switch_plan_order

bool

Ability to increase the resource quantity in an immediate switch plan order:

• true — the resource quantity can be increased.

• false — the resource quantity cannot be increased.

decrease_resources_immediate_switch_plan_order

bool

Ability to reduce the resource quantity in an immediate switch plan order:

• true — the resource quantity can be reduced.

• false — the resource quantity cannot be reduced.

relationships

object

Information about the related objects

plan_category

object

Information about the related plan category

data

object

Information about the plan category

id

string

ID of the plan category

type

string

Data type

links

array

Page navigation links that use the defined page navigation parameters

self

string

Current page link

first

string

First page link

prev

string

Previous page link

next

string

Next page link

last

string

Last page link