SMS

Text messages received by the dongle's SIM card (for example verification codes), and sending SMS from it.

Received messages

GET /proxies/{id}/sms

Ability: read · Newest first.

Query
`limit`	1–200, default 50

curl

Python

Node.js

PHP

curl 'https://proxykite.com/api/v1/proxies/7/sms?limit=10' \
  -H "Authorization: Bearer $HYP_TOKEN" \
  -H 'Accept: application/json'

import os
import requests

r = requests.get(
    "https://proxykite.com/api/v1/proxies/7/sms?limit=10",
    headers={"Authorization": f"Bearer {os.environ['HYP_TOKEN']}", "Accept": "application/json"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch('https://proxykite.com/api/v1/proxies/7/sms?limit=10', {
  headers: {
    Authorization: `Bearer ${process.env.HYP_TOKEN}`,
    Accept: 'application/json',
  },
  signal: AbortSignal.timeout(30000),
});
console.log(res.status, await res.json());

<?php
$ch = curl_init('https://proxykite.com/api/v1/proxies/7/sms?limit=10');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('HYP_TOKEN'),
        'Accept: application/json',
    ],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
var_dump($status, json_decode($body, true));

Response 200

{"data": [
  {"id": 55, "phone": "+919800000000", "content": "Your code is 123456", "received_at": "2026-10-09T18:00:00+00:00", "read": false}
]}

Send an SMS

POST /proxies/{id}/sms

Ability: manage · Who: account owner, team admin, or the reseller sub-user the proxy is assigned to · 20 requests/min. Sends one SMS from the dongle's SIM (operator charges apply). "OK" means the dongle accepted it, not that it was delivered. Counts toward the proxy's SMS limits.

Body field
`to`	phone number, digits with optional leading `+` (spaces, dashes, brackets are removed)
`text`	1–670 characters

curl

Python

Node.js

PHP

curl -X POST 'https://proxykite.com/api/v1/proxies/7/sms' \
  -H "Authorization: Bearer $HYP_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"to":"+919800000000","text":"Hello"}'

import os
import requests

r = requests.post(
    "https://proxykite.com/api/v1/proxies/7/sms",
    headers={"Authorization": f"Bearer {os.environ['HYP_TOKEN']}", "Accept": "application/json"},
    json={"to": "+919800000000", "text": "Hello"},
    timeout=30,
)
print(r.status_code, r.json())

const res = await fetch('https://proxykite.com/api/v1/proxies/7/sms', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.HYP_TOKEN}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"to":"+919800000000","text":"Hello"}),
  signal: AbortSignal.timeout(30000),
});
console.log(res.status, await res.json());

<?php
$ch = curl_init('https://proxykite.com/api/v1/proxies/7/sms');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('HYP_TOKEN'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => '{"to":"+919800000000","text":"Hello"}',
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
var_dump($status, json_decode($body, true));

Response 200

{"ok": true, "data": {"id": 31, "to": "+919800000000", "chars": 5, "sent_at": "2026-10-10T09:00:00+00:00"},
 "limits": {"day": {"limit": 50, "used": 13, "resets_at": "2026-10-10T18:30:00+00:00"}, "week": {…}, "month": {…}}}

429 — an SMS limit is used up (limit = the period that frees up last; Retry-After header in seconds):

{"error": "sms_limit_reached", "limit": "day", "max": 50, "used": 50,
 "resets_at": "2026-10-10T18:30:00+00:00", "message": "SMS limit reached: 50 of 50 this day. …"}

Other errors: 409 dongle_busy (a rotation or another SMS is running — retry shortly), 422 validation_failed (bad number or text), 502 sms_failed (the dongle refused or is unreachable).

#SMS

#Received messages

#Send an SMS

SMS

Received messages

Send an SMS