curl -X POST https://api.tracklysms.com/api/v1/voice/calling-numbers/quote \
-H "X-Api-Key: trk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "<string>",
"code": {},
"quoteId": "<string>",
"sku": "<string>",
"quantity": "<string>",
"amount": {},
"consentVersion": "<string>",
"recurringPolicy": {}
}Voice Calls (v1)
Quote a Calling Number
Get the current price and consent version for one monthly Voice number.
POST
/
v1
/
voice
/
calling-numbers
/
quote
curl -X POST https://api.tracklysms.com/api/v1/voice/calling-numbers/quote \
-H "X-Api-Key: trk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{}'
{
"status": "<string>",
"code": {},
"quoteId": "<string>",
"sku": "<string>",
"quantity": "<string>",
"amount": {},
"consentVersion": "<string>",
"recurringPolicy": {}
}Returns the current
number_month quote for quantity 1. Requires voice_calls.write, the Voice Calls product entitlement, and an API key created by a current account owner. Send an empty JSON object; the endpoint accepts no body fields.
Review amount, recurringPolicy, initialPeriod, and nextChargeAt before obtaining purchase consent. A quote with status: "unrated" cannot authorize a purchase. Send the returned quoteId and consentVersion when acquiring the number. The service rechecks the quote during purchase.
Response Fields
Example
curl -X POST https://api.tracklysms.com/api/v1/voice/calling-numbers/quote \
-H "X-Api-Key: trk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{}'
Error Codes
| Status | Code | Meaning |
|---|---|---|
| 403 | owner_required | The key’s creator is not a current account owner. |
| 422 | json_required, invalid_request, invalid_fields, invalid_quote | Send a valid empty JSON object; invalid_quote means the number quote is unavailable. |
| 429 | rate_limited | The account or key creator reached the quote request limit. |
| 503 | rate_limit_unavailable | Request admission is temporarily unavailable. |