Rate DID Tier Object
The Rate DID Tier Object defines the tiered pricing structure for rented DIDs (Direct Inward Dialing numbers). It specifies how pricing scales based on quantity thresholds, with incremental discounts applied as the number of rented DIDs increases.
Each tier includes pricing details (price_0 – price_6) and corresponding quantity levels (quantity_0 – quantity_6), allowing partners to determine costs dynamically based on volume. The object also references the associated DID classification and includes country and prefix information to identify the applicable rate context.
Rate DID Tier Object Attributes
The fields listed in the table below will be returned in a JSON object when a successful request has been made.
| Attribute | Data Type | Description |
|---|---|---|
| classification_sid read only | string | The phone number classification secure ID, which can be set to one of the DID Classification object secure IDs. |
| country_code read only | string | The ISO 3166-1 alpha-3 code of this rate. |
| country_name read only | string | The country name of this rate. |
| prefix read only | string | The number prefix for the DID. |
| price_0...price_6 read only | number | The price for this rate, which depends on the quantity of the rented DIDs. |
| quantity_0...quantity_6 read only | integer | The number of DIDs, which define the rate price. |
Sample Rate DID Tier Object
{
"classification_sid": "3306c614-772b-4477-8f29-714676c6d52c",
"country_code": null,
"country_name": null,
"prefix": null,
"price_0": "0.15",
"price_1": "0.12",
"price_2": "0.1",
"price_3": "0.07",
"price_4": "0.05",
"price_5": "0.02",
"price_6": "0.01",
"quantity_0": 0,
"quantity_1": 3,
"quantity_2":5,
"quantity_3": 6,
"quantity_4": 8,
"quantity_5": 9,
"quantity_6": 11
}
CarrierX offers flexible pricing, which depends on the quantity of rented DIDs. The more DIDs the partner rents, the lower the price for the DIDs exceeding the specified quantity is.