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

string

Prefix of the sending number the price applies to. null when the price applies to an SMS from any number.

destination_prefix

string

Destination prefix the price applies to. With filter[dst_number], the longest one covering the number among the prices that the filters admit. null when the price applies to any destination.

country

string

Destination country the price applies to, by name. null when the price is not attributed to a country.

mcc

integer

Mobile country code of the destination network the price applies to. null when the price applies to any network.

mcc_name

string

Name of the mobile country code. null when mcc is null.

mnc

integer

Mobile network code of the destination network the price applies to. null when the price applies to any network of the country.

mnc_name

string

Name of the mobile network. null when mnc is null.

reject_sms

boolean

true when the plan rejects SMS to this destination instead of pricing them. price is then null. A rejection is an answer, not a missing price.

price

string

Price per SMS in USD, VAT excluded, as a decimal string that is never rounded. null when reject_sms is true.

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.