Skip to main content
GET
Get tarif

Pricing

Use POST /purchases/quote to get the final order total. To calculate it yourself, use the tariff’s pricing object and the rules below. Prices are in pricing.currency, before discounts, for one hour (hourly: true) or one tariff period (hourly: false). discount is the effective percentage for your account and this tariff, including promotions. Use the returned value as-is. Quantity discounts are separate. Do not apply /me.discount again. For all three types, calculate the subtotal as described below, then:
Use duration = 1 when hourly: false. In the request, omit duration or send 1. For hourly tariffs, use the requested number of hours; omitting duration also defaults to 1. Round only the final total. Paid orders have a minimum total of 0.01.

Standard

price_per_unit is the base price of one unit. quantity_discounts maps each range’s first unit to a discount percentage. A range ends just before the next threshold; earlier units keep their discount. The returned schedule reflects your account’s terms. An empty object {} means no quantity discount.
The first 99 units cost 1 USD each; from the 100th unit onward, each costs 0.90 USD. The discount does not reprice earlier units. For 150 units, the subtotal is: 99 × 1 + 51 × 1 × 0.90 = 144.90 USD. With no quantity discounts, the subtotal is simply quantity × price_per_unit.

Fixed

price covers the whole package. The tariff’s count is fixed, so do not multiply by quantity. Quantity discounts do not apply.
With duration = 1, the total is 90 USD. For an hourly package, multiply by the requested hours before applying the discount.

Graduated

graduated_prices maps quantity thresholds to prices for the entire selected quantity. Choose the highest threshold that does not exceed quantity. If the quantity is below every threshold, use the first tier. Do not add tier prices or multiply by quantity. Quantity discounts do not apply.
For 150 units, the subtotal is 150. With duration = 2 and discount = 10, the total is 270 USD.

Legacy fields

Top-level price, pricing_type, graduated_prices and discounts remain for compatibility. Use pricing for new integrations. Unlike the prices inside pricing, top-level price and graduated_prices already include discounts and rounding. price covers the default quantity with duration = 1. The old pricing_type reports standard for both standard and fixed tariffs.

Authorizations

Authorization
string
header
required

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

Headers

Accept-Language
enum<string>
default:en

The language of the response

Available options:
en,
ru

Path Parameters

tarifId
integer
required

The ID of the tarif

Query Parameters

expand
enum<string>

Additional data to include in the response

Available options:
panel
Example:

"panel"

Response

OK

id
integer

The ID of the tarif

Example:

1

title
string

The title of the tarif (localized)

Example:

"Viewers"

text
string[]

Description lines (localized)

Example:
count

Quantity info. For custom_count tariffs returns {min, max}, otherwise a single integer.

Example:
price
number
deprecated

Legacy price for the default quantity and duration = 1, with discounts and rounding applied. Use pricing for base prices or POST /purchases/quote for an order total.

Example:

89.91

type
string

The group_id of the tarif

Example:

"viewers"

hourly
boolean

Whether the tarif supports hourly duration selection

Example:

true

pricing_type
enum<string>
deprecated

Legacy pricing type. Both standard and fixed packages report standard. Use pricing.type for the three pricing types.

Available options:
standard,
graduated
Example:

"standard"

graduated_prices
object | null
deprecated

Legacy tier prices with discounts and rounding applied; null for other pricing types. Use pricing.graduated_prices for prices before discounts.

Example:

null

discounts
object
deprecated

Legacy quantity discount schedule. For standard tariffs, use pricing.quantity_discounts. Each threshold starts a range ending just before the next threshold; earlier units keep their discounts.

Example:
panel
boolean

Whether the tarif supports panel

Example:

true

pricing
Standard · object

Base prices and applicable discounts for your account. Prices are per hour when hourly is true, otherwise per tariff period. Calculate the subtotal for the selected type, multiply by duration and (1 - discount / 100), then round to two decimal places. Use duration = 1 when hourly is false. Paid orders have a minimum total of 0.01. Use POST /purchases/quote for the payable total.

Example: