SMS.Red API for virtual numbers

The SMS.Red API purchases the same virtual numbers as the dashboard. Use it when your software needs an inbound SMS — QA for OTP screens, provisioning a work profile, or issuing a rental without a person in the UI.

Where to start

1. Sign in and open Developers.
2. Create an API key. Store it like a password.
3. Top up the wallet the key bills against.
4. Create a verification or a rental with the service code and country you need.
5. Poll messages or use a webhook if you configured one.

Service codes match the catalog (for example Telegram is `tg`, WhatsApp is `wa`, Google is `go`). Rentals need a duration the catalog actually sells. Do not hard-code a price — read it from the durations endpoint the same way the New rental page does.

Rate-limit your buyers. A loop that hammers “buy” will drain the wallet and still fail on apps that reject the prefix. Handle empty stock as an empty result, not a retry storm.