Whisper SMS API

How It Works

Get a Number: Call GET /getNumber/:tag?key=YOUR_KEY to acquire a new temporary phone number. Use a service tag from the list below (e.g. herosms, 5sim, smspva, smsman).
Check SMS: Poll GET /checkSms/:phone_number?key=YOUR_KEY to check if an SMS has arrived. Returns waiting_sms while pending.
Code Received: When the SMS arrives, returns received status with the verification code.
Cancel (Optional): Call GET /cancel/:phone_number?key=YOUR_KEY to cancel an active number.

Available Services

Endpoints

GET /getNumber/:tag Auth Required

Acquire a new temporary phone number. Includes automatic duplicate detection, retry logic, and proxy credentials.

{ "status": "success", "phone_number": "491234567890", "tag": "herosms", "proxy": { "rotating": "host:9000:user:pass", "sticky": "host:10000:user-session-RAND:pass" } }

GET /checkSms/:phone_number Auth Required

Check if an SMS has been received for the given phone number. A background checker also monitors automatically.

// Waiting: { "status": "waiting_sms", "phone_number": "491234567890" } // Received: { "status": "received", "phone_number": "491234567890", "code": "123456" }