Skip to content

clearance.rest

Wait for the SMS, the email, or the captcha result.

clearance.rest holds your request open until it arrives, then answers with the code. No polling, and no webhook to host.

Make your first requestAPI reference

GET /numbers/sms/wait

number=+14155550100

code_regex=\d{6}

X-Service-Timeout: 120000

200 OK

The request is open. Nothing to return yet.

{
  "success": true,
  "code": "482913",
  "from": "+15559998888",
  "to": "+14155550100",
  "body": "Your code is 482913",
  "receivedAt": 1785107161430
}

One request, one result

ServiceRequestWaits forReturns
NumbersGET /numbers/sms/waitAn SMS on a number you rent or attachThe message, and the code extracted from it
EmailsGET /emails/get-emailAn email to an address you own or connectThe email, and the code extracted from it
CaptchasPOST /captchas/resolveA solver finishing your captcha taskThe solver’s response, with a jobId

Where to go next

Authentication
Send your project’s API key in the X-API-Key header.
Timeouts
How long a request waits, and how to bound it.
Node.js and PHP SDKs
The same calls, with typed errors and deadlines built in.
Console
Find your API key and watch your usage.