Read a saved price plan
Look up price rows saved for your API account after browsing available phone numbers. Use the price option’s uuid from the selected number’s price list, not its number, prefix ID or area ID. Keep the selected number and price option together.
This is a compatibility lookup of saved pricing. It does not refresh availability or prices, reserve a number, place an order, or guarantee the amount of a future purchase. Review the price option returned with a fresh number search before ordering.
Request
Use your enabled API account over HTTPS from an allowed IP address. Set PRICE_ID to the exact price option ID you received. The method reads one path argument and no body, date or pagination parameters.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"The same account that obtained the price option must make this lookup. Do not construct an ID, use a database row number, or substitute another account’s selection. The legacy method matches only the visible price ID.
Response
The following fictional example shows selected customer-facing fields only. Actual responses return complete saved rows and can include additional account, supplier and internal pricing metadata. Keep the full response on your server and expose only the customer-facing values your application needs.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"visible_uuid": "PRICE_FROM_SEARCH",
"setup_price": "2.00",
"monthly_price": "4.50",
"per_minute": "0.0100",
"free_minutes": "100",
"channels": "2"
}
]
}response is a list, even for one row. status.results counts the returned rows. Database numeric values can be strings. The endpoint does not add a currency field or convert currencies; confirm the account’s billing currency rather than inferring it from this example.
Price fields
| Field | Meaning |
|---|---|
| visible_uuid | The saved price option’s visible identifier. Use the original option ID when correlating the lookup. |
| setup_price | Stored one-time setup price for this option. |
| monthly_price | Stored recurring monthly price. |
| per_minute, free_minutes | Stored incoming-call minute rate and included-minute quantity. These do not quote outgoing calls or every possible surcharge. |
| channels | Stored channel quantity for this option; it is not a live capacity or registration check. |
| yearly_price | An additional stored yearly-price field may be present. Do not infer that a nonzero monthly price and a zero yearly field represent a free yearly plan. |
Handle multiple matching rows
A lookup can return more than one saved row. The method provides no guaranteed ordering, latest-row selection or number/prefix filter. Do not silently choose the first or last row. Compare the returned context with the original selected number and price option; if it remains ambiguous or stale, refresh the number search instead of treating this response as an order quote.
The portal’s order-review workflow performs additional selection and validity checks. Do not assume this legacy lookup implements those checks or accepts every identifier the portal accepts.
Empty responses and errors
If no saved row matches, the current handler emits no JSON result and no explicit not-found response. An empty body is not a zero price, an available plan or a confirmed successful lookup. Check both the HTTP response and JSON structure; do not order from missing or unparseable price data.
Authentication, source-IP restrictions and database failures can also prevent a usable response. There is no handler-specific error envelope for a database exception. Refresh your selection or contact support when an authenticated lookup remains unavailable.
Effects and limits
The reviewed lookup performs a read query and contains no debit, purchase, reservation or provider-price refresh. Reading saved pricing does not establish current inventory, regulatory approval, account purchase permission or final billing.