• Title Content
  • API URL https://mail.zyptio.com/api/v2
  • Response Format JSON
  • HTTP Method POST
  • Your API Key
    Your API key
  • Example PHP Code Code
Service List:
  • Required Parameter Content
  • key Your API Key
  • action "services"
Service List Success Response:
                                        
                                            [
                                                {
                                                    "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,
                                                }
                                            ]
                                        
                                    
Service List Error Response:
                                        
                                            {"error" : "The action field is required"}
                                            {"error" : "The api key field is required"}
                                            {"error" : "Invalid api key"}
                                            {"error" : "Invalid action"}
                                        
                                    
Place New Order:
  • Required Parameter Content
  • key Your API Key
  • action "add"
  • service Service ID
  • link Link to Page
  • quantity Quantity to be Delivered
  • runs(Optional) Runs to Deliver
  • interval(Optional) Interval in Minutes
New Order Success Response:
                                        
                                            {
                                                "order": 1242
                                            }
                                        
                                    
New Order Error Response:
                                        
                                            {"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"}
                                        
                                    
Order Status:
  • Required Parameter Content
  • key Your API Key
  • action "status"
  • order Order ID
Order Status Success Response:
                                        
                                            {
                                                "status" : "Pending",
                                                "start_count" : "1000",
                                                "remains" : "500",
                                                "currency" : USD
                                            }
                                        
                                    
  • Available status
  • Pending
  • Processing
  • Complete
  • Order Cancelled
  • Refunded
Order Status Error Response:
                                        
                                            {"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"}
                                        
                                    
Order Refill:
  • Required Parameter Content
  • key Your API Key
  • action "refill"
  • order Order ID
Order Refill Success Response:
                                        
                                            {
                                                "success": "Your order will be refill asap. Thank you for patience",
                                                "refill": 12345
                                            }
                                        
                                    
Order Refill Error Response:
                                        
                                            {"error" : "Order not eligible for refill"}
                                        
                                    
Get Refill Status:
  • Required Parameter Content
  • key Your API Key
  • action "refill_status"
  • refill Refill ID
Refill Status Success Response:
                                        
                                            {
                                                "status": "Completed"
                                            }
                                        
                                    
User Balance:
  • Required Parameter Content
  • key Your API Key
  • action "balance"
User Balance Success Response:
                                        
                                            {
                                                "balance": "100.84292",
                                                "currency" :" USD"
                                            }
                                        
                                    
User Balance Error Response:
                                        
                                            {"error" : "The action field is required"}
                                            {"error" : "The api key field is required"}
                                            {"error" : "Invalid api key"}
                                        
                                    
SMS Numbers & Rentals API

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.

  • API URLhttps://mail.zyptio.com/api/v2
  • Method / formatPOST, form fields or JSON body · JSON response
  • Prices & chargesIn USD, taken from your balance; check it with action=balance
  • Errors{"error": "..."} with HTTP 200, like the SMM API
  • Rate limit300 requests a minute per API key (HTTP 429 above that)
Recommended flow for a reseller site
  1. Load and cache your catalog every few minutes: sms_countries → sms_services → sms_offers (rentals: sms_durations first, then the same with type=rental&duration=…).
  2. Buy with 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.
  3. Set a webhook (below) to be told the moment a code arrives. Or poll sms_status every 5–10 seconds, or many orders at once with orders=1,2,3.
  4. No code before it expires? It is refunded automatically. Want out sooner? sms_cancel refunds straight away.
  5. Got the code? sms_finish releases a one-time number; a rental stays yours until it expires.
sms_countries

Countries with numbers on sale, the lowest price and total stock.

  • ParameterContent
  • key, actionYour API key, "sms_countries"
  • type (optional)otp | rental
  • duration (optional)Rental length in hours, to list only countries renting that length
[
  {"country": "United States", "from": 0.5, "stock": 112223},
  {"country": "United Kingdom", "from": 0.34, "stock": 8890}
]
sms_services

Services (Telegram, WhatsApp…) on sale in a country.

  • ParameterContent
  • key, actionYour API key, "sms_services"
  • countryCountry name exactly as sms_countries returns it
  • type, duration (optional)As above
[
  {"service": "Telegram", "from": 0.5, "stock": 112223},
  {"service": "WhatsApp", "from": 0.6, "stock": 137851}
]
sms_durations

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"}
]
sms_offers

Every offer for a country and service, one per provider and carrier, cheapest first. Use the offer id to buy exactly that one.

  • ParameterContent
  • key, actionYour API key, "sms_offers"
  • country, serviceNames from the calls above
  • type, duration (optional)For rentals pass type=rental and the duration
[
  {
    "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.

sms_order

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.

  • ParameterContent
  • key, actionYour API key, "sms_order"
  • offerOffer id — or —
  • country, serviceNames; optional operator to insist on a carrier
  • typeotp (default) | rental
  • durationHours; required for rentals bought by country and service
  • ref (recommended)Your own unique id, up to 64 characters. Repeating it returns the existing order with "duplicate": true instead of buying again.
{
  "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"}
sms_status

Where an order stands and every SMS received. A single order is checked live with the provider before answering.

  • ParameterContent
  • key, actionYour API key, "sms_status"
  • orderOur order id — or ref with your own id
  • orders (bulk)Up to 100 ids, comma separated, e.g. 5821,5822. Returns an object keyed by id, from our records (refreshed every minute).
{
  "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"}
  ]
}
  • Statuses
  • waitingNumber issued, no SMS yet
  • receivedAt least one SMS arrived; see code and messages
  • completedFinished (or the rental ran its course)
  • refundedNothing arrived, cancelled or expired; money returned to your balance
  • cancelled / expiredClosed
sms_cancel · sms_finish · sms_resend · sms_orders
  • ActionWhat it does (takes order or ref)
  • sms_cancelHand back a number that has not received an SMS and get refunded at once. Some providers refuse cancellation in the first 2 minutes.
    {"order": 5821, "status": "refunded", "refund": 0.5, "balance": 12.4}
  • sms_finishClose a one-time number once you have the code.
    {"order": 5821, "status": "completed"}
  • sms_resendAsk for another SMS on the same number, where the provider supports it.
  • sms_ordersYour recent orders, newest first. Optional type (otp | rental) and limit (1–200, default 50).
Webhook (push instead of polling)

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 example
<?php
function zyptio(array $params) {
    $params['key'] = 'YOUR_API_KEY';
    $ch = curl_init('https://mail.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'] ?? '');

We may use cookies or any other tracking technologies when you visit our website, including any other media form, mobile website, or mobile application related or connected to help customize the Site and improve your experience. learn more

Allow