[
{
"service": 1,
"name": "YouTube Livestream Viewers",
"rate": "0.33000000",
"min": 1000,
"max": 200000,
"category": "Live Stream [ Low ConCurrent | Less Price ] [ 30 Minutes to 24 Hours]",
"refill": true,
"dripfeed": true,
},
{
"service": 2,
"name": "YouTube Livestream Viewers ~",
"rate": "2.10000000",
"min": 1000,
"max": 200000,
"category": "Live Stream [ Low ConCurrent | Less Price ] [ 30 Minutes to 24 Hours]"
"refill": true,
"dripfeed": false,
}
]
{"error" : "The action field is required"}
{"error" : "The api key field is required"}
{"error" : "Invalid api key"}
{"error" : "Invalid action"}
{
"order": 1242
}
{"error" : "The action field is required"}
{"error" : "The api key field is required"}
{"error" : "Invalid api key"}
{"error" : "Invalid Service Id"}
{"error" : "The link field is required"}
{"error" : "The quantity field is required"}
{"error" : "Please follow the limit"}
{"error" : "Insufficient balance"}
{
"status" : "Pending",
"start_count" : "1000",
"remains" : "500",
"currency" : USD
}
{"error" : "The action field is required"}
{"error" : "The api key field is required"}
{"error" : "Invalid api key"}
{"error" : "Invalid action"}
{"error" : "The order field is required"}
{"error" : "Invalid Order Id"}
{
"success": "Your order will be refill asap. Thank you for patience",
"refill": 12345
}
{"error" : "Order not eligible for refill"}
{
"status": "Completed"
}
{
"balance": "100.84292",
"currency" :" USD"
}
{"error" : "The action field is required"}
{"error" : "The api key field is required"}
{"error" : "Invalid api key"}
Same URL, same API key, same POST format as the SMM API above. Every SMS action starts with sms_.
One-time numbers (a single verification code) and rentals (a number you keep for hours or days) share the same actions and are told apart by the type parameter:
otp (default) or rental.
action=balance{"error": "..."} with HTTP 200, like the SMM APIsms_countries → sms_services → sms_offers
(rentals: sms_durations first, then the same with type=rental&duration=…).sms_order, passing your own order id as ref.
If the request times out, send it again with the same ref: you get the same order back, never a second charge.sms_status every 5–10 seconds, or many orders at once with orders=1,2,3.sms_cancel refunds straight away.sms_finish releases a one-time number; a rental stays yours until it expires.Countries with numbers on sale, the lowest price and total stock.
[
{"country": "United States", "from": 0.5, "stock": 112223},
{"country": "United Kingdom", "from": 0.34, "stock": 8890}
]
Services (Telegram, WhatsApp…) on sale in a country.
[
{"service": "Telegram", "from": 0.5, "stock": 112223},
{"service": "WhatsApp", "from": 0.6, "stock": 137851}
]
Rental lengths on sale right now, in hours. Optional country narrows it to one country.
[
{"duration": 24, "label": "1 day"},
{"duration": 168, "label": "1 week"},
{"duration": 720, "label": "1 month"}
]
Every offer for a country and service, one per provider and carrier, cheapest first. Use the offer id to buy exactly that one.
[
{
"offer": 190529,
"provider": "Tsms",
"operator": "any",
"operator_name": "Any operator",
"type": "otp",
"price": 0.5,
"currency": "USD",
"stock": 112223,
"success_rate": 94.5,
"rate_source": "ours",
"duration": 0,
"duration_label": "One time"
}
]
success_rate: share of numbers that received an SMS. rate_source "ours" = measured from our own recent orders, "provider" = stated by the provider, null = no data yet.
Buy a number. Name an offer from sms_offers, or give a country and service and the cheapest in stock is taken. If that provider refuses, the next cheapest equivalent is tried automatically; you are only charged for a number you actually get.
operator to insist on a carrier{
"order": 5821,
"ref": "mysite-10442",
"status": "waiting",
"number": "+12025550147",
"country": "United States",
"service": "Telegram",
"operator": "any",
"type": "otp",
"duration": 0,
"charge": 0.5,
"currency": "USD",
"expires": "2026-11-06 14:20:00"
}
{"error": "Insufficient balance. Please deposit and try again."}
{"error": "No numbers are available for that combination"}
{"error": "The duration field is required for rentals; see sms_durations"}
{"error": "Invalid or unavailable offer id"}
Where an order stands and every SMS received. A single order is checked live with the provider before answering.
ref with your own id{
"order": 5821,
"ref": "mysite-10442",
"status": "received",
"number": "+12025550147",
"country": "United States",
"service": "Telegram",
"type": "otp",
"charge": 0.5,
"currency": "USD",
"expires": "2026-11-06 14:20:00",
"code": "48213",
"messages": [
{"sender": "Telegram", "text": "Telegram code: 48213", "code": "48213", "received": "2026-11-06 14:02:11"}
]
}
order or ref){"order": 5821, "status": "refunded", "refund": 0.5, "balance": 12.4}{"order": 5821, "status": "completed"}type (otp | rental) and limit (1–200, default 50).
Set a callback URL on your API page. We POST JSON to it when a code arrives, when an order completes and when one is refunded, and retry if your server does not answer 2xx. Each request carries X-Sms-Signature:
the HMAC-SHA256 of the raw body keyed with your signing secret. Verify it before trusting the data.
{
"event": "code.received",
"order": 5821,
"ref": "mysite-10442",
"status": "received",
"number": "+12025550147",
"country": "United States",
"service": "Telegram",
"type": "otp",
"code": "48213",
"messages": [{"sender": "Telegram", "text": "Telegram code: 48213", "code": "48213", "received": "2026-11-06 14:02:11"}],
"sent_at": "2026-11-06 14:02:12"
}
Events: code.received, order.completed, order.refunded.
<?php
function zyptio(array $params) {
$params['key'] = 'YOUR_API_KEY';
$ch = curl_init('https://www.zyptio.com/api/v2');
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_POSTFIELDS => http_build_query($params),
CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 60]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
return $response;
}
// Buy the cheapest US Telegram number, safely retryable thanks to ref
$order = zyptio(['action' => 'sms_order', 'country' => 'United States',
'service' => 'Telegram', 'ref' => 'mysite-10442']);
if (isset($order['error'])) { exit($order['error']); }
// Rent a number for 1 week
$rental = zyptio(['action' => 'sms_order', 'type' => 'rental', 'duration' => 168,
'country' => 'United Kingdom', 'service' => 'WhatsApp', 'ref' => 'mysite-10443']);
// Poll several orders in one call (or use the webhook)
$statuses = zyptio(['action' => 'sms_status', 'orders' => $order['order'] . ',' . $rental['order']]);
// Verifying a webhook on your side
$body = file_get_contents('php://input');
$valid = hash_equals(hash_hmac('sha256', $body, 'YOUR_SIGNING_SECRET'), $_SERVER['HTTP_X_SMS_SIGNATURE'] ?? '');