# SMS OUT Price Object

An SMS OUT price returned by [Look up SMS OUT Prices](lookup-sms-out-prices.html) 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.
