Wait for the OTP code
wait_for_otpPoll an SMS order until the one-time verification code arrives or the timeout expires. Returns the delivered OTP; on timeout, the number stays active for another attempt or refund.
Instructions
Poll an order until its verification code arrives, it expires, or the timeout is hit. Returns the code when delivered. On timeout the number is still active — call again, or release() to refund now.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"order_id": "<order_id>"
},
"name": "wait_for_otp"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes | The order_id returned by get_number. | |
| timeout_seconds | No | How long to wait before giving up (default 180, max 1200). | |
| poll_interval_seconds | No | Seconds between polls (default 10, min 5 to respect the 60/min limit). |