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 loop and no webhook to host for any wait. Use the REST API, an SDK, or let an AI agent call it through MCP. You pay per use from a USD balance.
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",
"message_id": "0190...",
"received_at": "2026-10-25T10:00:03.120Z"
}One request, one result
| Service | Request | Waits for | Returns |
|---|---|---|---|
| Numbers | GET /numbers/sms/wait | An SMS on a temporary, monthly or device number | The message, and the code extracted from it |
| Emails | GET /emails/wait | An email to a mailbox you connected | The email, and the code extracted from it |
| Captchas | POST /captchas/resolve | The captcha being solved | The solution, with the same shape for every type |
Where to go next
- Quickstart
- Create an account, add balance and receive your first SMS.
- Authentication
- Send your project’s API key in the
X-API-Keyheader. - Billing
- What costs money, spend limits and refunds.
- MCP
- Let Claude, Cursor or any MCP client rent numbers and solve captchas within a budget.
- Webhooks
- Be told when a number expires, a mailbox connects or the balance runs low.