Buy a Czech mobile SMS number
Buys a Czech mobile SMS number for the account. Send no body; we pick the number. The number receives SMS (read them with GET /v1/messages?direction=in or the message.received webhook event) and you send from it with fromNumber on POST /v1/messages. It does not make or receive calls. 390.00 CZK excluding VAT is charged from the credit balance right away for the first 30-day period and again every 30 days; the paid period is not refunded when you release the number. An account can hold at most two SMS numbers, and buying requires a first credit top-up. If something fails at the carrier after the purchase, the number is released again and nothing is charged. While another purchase for the account is still running you get 429 rate_limited; wait a few seconds and repeat it. Supports Idempotency-Key: after a timeout send the same value so a retry cannot buy a second number. Delivery of messages from every sender, including verification codes, is not guaranteed.
Request
- Base URL: https://volai.cz
- URL: https://volai.cz/v1/sms-numbers
- Auth: HTTP bearer
Headers
Optional key for one logical request. Its scope is global to this API key, independent of the HTTP method, path, or body: use a new value for every distinct logical action across all endpoints and request bodies, and reuse it only to retry the exact same logical request. Reusing a non-blank key within 24 hours returns the stored response; a concurrent request with the same key returns 409 idempotency_in_progress. A missing or whitespace-only value disables idempotency.
Response
Bought SMS number
Changes
No recorded changes to this operation across all 1 revision of this API.