SMS OUT Price Object#
An SMS OUT price returned by Look up SMS OUT Prices for the
A2P, P2P and OTP domains. Resource type: prices.
The id is a UUID derived from the content of the price: it stays the same across requests
while the price is unchanged, and differs for different prices. Any change to the price,
including its amount, gives it a new id, so the id does not follow the price of a
destination over time. There is no endpoint that returns a single price by its ID.
Attributes#
Name |
Type |
Description |
|---|---|---|
source_prefix |
|
Prefix of the sending number the price applies to. |
destination_prefix |
|
Destination prefix the price applies to. With |
country |
|
Destination country the price applies to, by name. |
mcc |
|
Mobile country code of the destination network the price applies to. |
mcc_name |
|
Name of the mobile country code. |
mnc |
|
Mobile network code of the destination network the price applies to. |
mnc_name |
|
Name of the mobile network. |
reject_sms |
|
|
price |
|
Price per SMS in USD, VAT excluded, as a decimal string that is never rounded. |
Prices are printed without rounding, with trailing zeros dropped and at least one decimal
kept, for example 0.0, 1.5 or 0.0525.
Prices under one destination prefix can differ by the sending number they apply to
(source_prefix), by the destination network (mcc and mnc, which only the delivery
decides) and by plan settings that the API does not return. A lookup therefore returns the
prices of the plan that apply, not the one price that is charged. Prices that are equal in
every stored value are returned once. Two prices can still look alike, because they can
differ in settings that the API does not return; their id values then differ.