Grand SMS
Dokumentace API

Dokumentace API

Začněte jedním požadavkem

14 · Řízení APIREST + handler_api.phpJSON / plain text · Bearer

Vytvořte klíč API ve vaší tabulce, získejte číslo a kontrolujte zprávy každých 10 sekund. Platba je kreditována, když SMS s kódem přijde; čtení znovu neovlivňuje vaši rovnováhu.

REST APIhttps://smscash.org/api/v1
Základní URL APIhttps://smscash.org/stubs/handler_api.php
Služba je živátelefonní čísla , SMS Výnosy jsou k dispozici, výnosy se nacházejí USDT na TRC20Platby se odehrávají mezi 1 a 45 Dny jsou.
Příklad žádosti · cURL
curl --get 'https://smscash.org/stubs/handler_api.php' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'action=getNumber' \
  --data-urlencode 'service=go' \
  --data-urlencode 'country=86'

Alternativní kompatibilní rozhraní adresa: /handler_api.php. Stávající integrace REST pokračují v práci.

API

Tvůrce požadavků

cURL · Go · JS · Python
Základní URL APIhttps://smscash.org/stubs/handler_api.php
cURL
curl --max-time 15 --fail-with-body 'https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1'

Klíč se neukládá. Toto ověření nepřiděluje čísla.

Zbývají nové integrace

Služby a země

Vyberte si službu a zemi. platba SMS závisí na zemi.

REST
GET /api/v1/catalog?service=go&country=86&page=1&page_size=100
Authorization: Bearer YOUR_API_KEY
JSON
{
  "rows": [
    {
      "offer_id": 42,
      "service": "go",
      "service_name": "Google",
      "country_id": 86,
      "country_name": "Italy",
      "provider_id": 1,
      "operator": 1,
      "provider_name": "operator=1",
      "reward": "0.00300000",
      "currency": "USD",
      "accounting_precision": 8,
      "earnings_hold_days": 45
    }
  ],
  "page": 1,
  "page_size": 100,
  "total": 1,
  "pages": 1,
  "has_more": false,
  "accounting_precision": 8
}

service · country · operator · q · page · page_size (1–100)

Získejte číslo
handler_api.php
GET /stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86

Automatický výběr: náhodný dostupný operátor.

REST
ACCESS_NUMBER: session ID · phone number
service + country · session_duration: 20
ref: software owner code (optional)
operator: public ID (e.g. 1) or comma-separated IDs (e.g. "1,3")
optional · omitted/any/0: random eligible provider
country: integer · service: string · SMS code: string

Číslo je platné po dobu 20 minut. SMS je kontrolován každých 10 sekund. můžete okamžitě zrušit.

Ověřit více čísel
REST
GET /api/v1/activations/batch?ids=42,43
Authorization: Bearer YOUR_API_KEY
JSON
{
  "rows": [
    {
      "id": 42,
      "found": true,
      "phone": "12025550123",
      "status": "received",
      "service": "go",
      "country_id": 86,
      "provider_id": 1,
      "operator": 1,
      "expires_at": "2026-10-10T12:15:00Z",
      "sms_count": 1,
      "code": "001234",
      "last_sms": {
        "id": 101,
        "code": "001234",
        "sender": "Service",
        "text": "Code: 001234",
        "received_at": "2026-10-10T12:01:00Z"
      }
    },
    {
      "id": 43,
      "found": false,
      "error": {
        "code": "NO_ACTIVATION",
        "message": "Session not found."
      }
    }
  ],
  "as_of": "2026-10-10T12:01:00Z",
  "poll_interval_seconds": 10
}
REST
ids: 1–100 positive session IDs, separated by commas
Input order preserved · duplicates removed
Foreign, unavailable or out-of-scope IDs: found=false
Read only · no supplier requests · last_sms is the latest message
Zůstatek · Pozastaveno
REST
GET /api/v1/balance
Authorization: Bearer YOUR_API_KEY
JSON
{
  "currency": "USD",
  "accounting_precision": 8,
  "balance": "12.00000000",
  "held_balance": "34.50000001",
  "balance_minor": "1200000000",
  "held_minor": "3450000001",
  "as_of": "2026-10-12T20:00:00Z",
  "next_release_at": "2026-11-26T20:00:00Z"
}

balance — Dostupné; held_balance — Pozastaveno. USD · 8

Vybrat lze pouze prostředky, u kterých skončila čekací doba.

Klienti připravení k použití

JavaScript · Node.js 18+
import {SmScash, SmScashError} from './smscash.mjs';

const api = new SmScash(process.env.SMSCASH_API_KEY);
const catalog = await api.catalog({service: 'go', country: 86});
console.log(catalog.rows);

const messages = await api.sms(42, {afterId: 0});
console.log(messages.sms);
const statuses = await api.batch([42]);
const held = await api.holdBalance();
console.log(held); // Exact USD string
Python 3.9+
import os
from smscash import SmScash, SmScashError

api = SmScash(os.environ['SMSCASH_API_KEY'])
catalog = api.catalog(service='go', country=86)
print(catalog['rows'])

messages = api.sms(42, after_id=0)
print(messages['sms'])
statuses = api.batch([42])
held = api.hold_balance()
print(held) # Exact USD string
SDK
me() · balance() · holdBalance()/hold_balance() · catalog() · activation() · sms() · batch()
setStatus(id, "cancel") / set_status(id, "cancel")
Timeout: 15 s · no dependencies · no automatic retries
Error: code · status · hint · requestId/request_id · retryable
ALLOCATION_UNCERTAIN: contact support with request_id; never retry automatically.

SMS-Activate / HeroSMS

SMS-Activate · Základní URL APIhttps://smscash.org/sms-activate/stubs/handler_api.php
HeroSMS · Základní URL APIhttps://smscash.org/hero-sms/stubs/handler_api.php

Osobní API klíč uživatele.

Vyberte si službu a zemi. platba SMS závisí na zemi.

KódPopis
getNumber / getNumberV2Získejte číslo
getStatus / getStatusV2Získejte nejnovější kód
setStatus / finishActivation / cancelActivationŘízení sezení
getPrices / getNumbersStatusZkontrolujte dostupnost
getRewards (SMScash)Odměna za SMS
getServicesList / getServicesSlužby
getCountries / getOperatorsSlužby a země
getActiveActivationsSezóny
getBalanceZůstatek uživatele
getHoldBalance (SMScash)Pozastaveno

cost = 0 USD · activationCost = 0 USD
reward — Odměna za SMS

HeroSMS · cURL
curl --get 'https://smscash.org/hero-sms/stubs/handler_api.php' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'action=getNumberV2' \
  --data-urlencode 'service=go' \
  --data-urlencode 'country=86'
Odpovědi
{
  "activationId": "42",
  "phoneNumber": "393331234567",
  "activationCost": 0,
  "currency": 840,
  "countryCode": 86,
  "canGetAnotherSms": true,
  "activationTime": "2026-10-11T12:00:00Z",
  "activationEndTime": "2026-10-11T12:15:00Z",
  "reward": "0.00300000"
}
SMS-Activate / HeroSMS
GET or POST application/x-www-form-urlencoded
api_key · action · service · country · ref (optional)
setStatus: 1 → ACCESS_READY · 3 → ACCESS_RETRY_GET
           6 → ACCESS_ACTIVATION · 8 → ACCESS_CANCEL
getStatus: STATUS_WAIT_CODE · STATUS_OK:001234 · STATUS_CANCEL
getStatusV2: {"verificationType":1,"sms":null,"call":null}
getServicesList: {"status":"success","services":[{"code":"go","name":"Google"}]}
getCountries: {"86":{"id":86,"eng":"Italy","visible":1,"retry":1,"rent":0}}
getPrices: {"86":{"go":{"cost":0,"count":12,"reward":"0.00300000","currency":"USD"}}}
getRewards: {"59":{"vi":{"1":"0.01000000"}}}
getRewards filters: country · service · operator (optional, e.g. 1,3); any/0: all permitted providers
getActiveActivations: start=0 · limit=1–100 · activeActivations / data
Business/key errors: HTTP 200 + plain text · server errors: HTTP 500
Availability: actual supplier pool, shared cache up to 20 s; not a reservation
No automatic retries after a transport error or ALLOCATION_UNCERTAIN.
Unsupported: rent · calls · forwarding · multiple services per number · prolong
Unsupported options return BAD_REQUEST; unsupported actions return BAD_ACTION.
SMScash keys and country/service codes; configure this base URL in your software.

Číslo je platné po dobu 20 minut. SMS je kontrolován každých 10 sekund. můžete okamžitě zrušit.

Autentikace a odchody

REST: Hledá Authorization: Bearer YOUR_API_KEY. kompatibilní rozhraní: parametry api_key a actionPoužijte HTTPS

Chcete-li spravovat klíče API, zadejte svůj účet.

∞Požadavky / min na účet
∞Souběžné zasedání

Častota požadavků API a počet telefonních čísel jsou neomezené.Neexistují denní nebo hodinové kvóty.

Číslo je platné po dobu 20 minut. SMS je kontrolován každých 10 sekund. můžete okamžitě zrušit.

Klíčový rozsah API

Můžete omezit klíč na konkrétní služby, země a poskytovatele. prázdné seznamy umožňují všechny dostupné možnosti.

JSON
{
  "label": "Můj software",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} Změna názvu a politiky zcela. Tajemství je zřejmé pouze tehdy, když je vytvořeno.

10% v celkové. 5% + 5% s softwarovým kódem.

Při vydávání čísla, prosím, poskytněte ref majitel softwaru. žádost je pověřena klíčem prováděcího. kód je v sekci "Referrals" a v GET /api/v1/referrals → software_ref.

ŽádostPozvánkaSoftware
Bez ref10%—
s ref5%5%
S ref, bez referera—5%

Platba platby platby bez snížení výnosů uživatele. majitel softwaru a referer může být stejná osoba.

Termíny jsou stanoveny, když je vytvořena schůze; čtení SMS a odchod se nemění. Přejít ref znovu pro novou opakovanou schůzi. V výpočtu poplatků, odměna uživatele USD 0.003 dává USD 0.00015 každý majiteli softwaru a referera. Celkový bonus je USD 0.00030.

Řízení API

11 XVBC-tylu metody plus váš SMScash rovnováha.

GETgetNumberZískejte číslo

Vytváří se zasedání a rezervuje k dispozici číslo pro uživatele. sazba odměny a referenční příjemci jsou fixovány na přidělení; odměna je kreditována, když SMS s kódem přijde.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
service*stringK dispozici jsou servisní kódy. Odpověď je omezena na oblast klíče API.
country*integerVzít ID od getCountries.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · any/0
session_durationintegerSezóna trvá 20 minut. projděte 20 nebo omezte tento parametr.
with_operatorinteger1 přidá do odpovědi ID operátora; 0 nebo vynechaný parametr vrátí tři části.
refstringПубличный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.

* Požadovaný parametr. ve všech požadavcích také projít akce =getNumber.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1'

Odpovědi

vydané číslo
ACCESS_NUMBER:42:380670000000:1
Žádné dostupné čísla
EMPTY_POOL
  • Automatický výběr: náhodný dostupný operátor.
  • Číselná země bez bazénu poskytuje EMPTY_POOL; chybný formát země je BAD_COUNTRY.
  • Klíč k odstraněné sezení zůstává použit: přehrávání přidělení s tímto klíčem vrátí SESSION_CLOSED a nevydává další číslo.
  • Výsledek přidělení není potvrzen. automatické odstupování je znemožněno, aby se zabránilo přidělování druhého čísla.
GETgetNumbersStatusZkontrolujte dostupnost

Telefonní čísla jsou k dispozici podle služby a země.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
country*integerVzít ID od getCountries.

* Požadovaný parametr. ve všech požadavcích také projít akce =getNumbersStatus.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86'

Odpovědi

Dostupné čísla
{
  "go_0": 0
}
  • _0 suffix znamená volbu bez konkrétního operátora.
  • Dostupnost se vztahuje na celkový bazén dodavatele.Vybraný kanál se kontroluje, když je přidělen číslo.
GETgetStatusZískejte nejnovější kód

Jednoduchá žádost o status sezení a poslední SMS kód. Vedoucí zeros v kódu jsou zachovány.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
id*integerID vašeho zasedání, které bylo obdržené po vydání čísla.

* Požadovaný parametr. ve všech požadavcích také projít akce =getStatus.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42'

Odpovědi

Čekání
STATUS_WAIT_CODE
Kód přijatý
STATUS_OK:001234
Zrušení nebo uplynutí platnosti
STATUS_CANCEL
Nenašli
NO_ACTIVATION
  • Poll každých 20 sekund. čtení zprávy znovu neznamená další platbu.
  • Poté retry starý kód není zpět: getStatus počkat na další SMS.
  • Po čísle bez SMS je vymazán, getStatus a getSms Návrat STATUS_CANCEL; getSmsFull vrátí zavřený stav, prázdný telefon a prázdný sms a seznam . REST /activations/{id} a /sms Návrat 404 NO_ACTIVATION.
GETsetStatusŘízení sezení

Končí, zruší nebo znovu čeká na SMS.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
id*integerID vašeho zasedání, které bylo obdržené po vydání čísla.
status*integer3 – čekat na další kód bez prodloužení sezení; 6 – dokončit po SMS; 8 – okamžitě zrušit.

* Požadovaný parametr. ve všech požadavcích také projít akce =setStatus.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3'

Odpovědi

Čekání na SMS
ACCESS_RETRY_GET
dokončená
ACCESS_ACTIVATION
Zrušený
ACCESS_CANCEL
  • Odstoupí čeká na další kód do původních 20 minut. Výstup a časy uplynutí se nezmění.
  • Zrušení nezruší odměny, které již získal.
  • V historii jsou uchovávány pouze čísla s kódem SMS. Odstraněné a vypršené čísla bez kódu jsou odstraněny.
GETgetRepeatNumberZnovu si vytáhněte stejné číslo

Otevřete novou schůzku s konkrétním číslem z vašeho historie.Můžete si vybrat jinou dostupnou službu ve stejné zemi.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
number*stringVaše staré číslo. pouze čísla a volitelný vedoucí + jsou povoleny.
service*stringK dispozici jsou servisní kódy. Odpověď je omezena na oblast klíče API.
session_durationintegerSezóna trvá 20 minut. projděte 20 nebo omezte tento parametr.
with_operatorinteger1 přidá do odpovědi ID operátora; 0 nebo vynechaný parametr vrátí tři části.
refstringПубличный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · any/0

* Požadovaný parametr. ve všech požadavcích také projít akce =getRepeatNumber.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go'

Odpovědi

Nová zasedání
ACCESS_NUMBER:43:380670000000
Číslo je stále zaneprázdněné
NUMBER_IN_USE
  • Nejprve ukončte nebo zrušte aktuální sezení. Pokud je číslo zaneprázdněné, re-exuance se neprovádí.
  • Nová sezení dostane nový ID a aktuální sazbu. staré SMS nejsou kopírovány do něj. ref je znovu nastaven.
  • SMScash umožňuje opakovat pouze čísla z historie tohoto účtu.
  • Klíč k odstraněné sezení zůstává použit: přehrávání přidělení s tímto klíčem vrátí SESSION_CLOSED a nevydává další číslo.
GETgetSmsFullSMS jako JSON

Struktura historie všech zpráv s ID, odesílatel, kód, text a země, služba a data dodavatele.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
id*integerID vašeho zasedání, které bylo obdržené po vydání čísla.

* Požadovaný parametr. ve všech požadavcích také projít akce =getSmsFull.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42'

Odpovědi

JSON
{
  "success": true,
  "session_id": 42,
  "phone": "380670000000",
  "status": 1,
  "status_name": "received",
  "sms_count": 1,
  "sms": [
    {
      "id": 101,
      "external_id": "message-101",
      "sender": "Service",
      "code": "001234",
      "text": "Код подтверждения: 001234",
      "received_at": "2026-10-09T12:00:00Z",
      "country": {
        "id": 86,
        "name": "Italy"
      },
      "service": {
        "code": "go",
        "name": "Google"
      },
      "provider": {
        "id": 1,
        "name": "operator=1"
      }
    }
  ],
  "expires_at": "2026-10-09T12:20:00Z"
}
  • Vymyslete si SMS[].id pro zpracování pouze nových zpráv.
  • Číselný status SMScash: 1 - aktivní, 6 - dokončený, 8 - zrušený nebo uplynul. status_name rozlišuje mezi čekáním, přijatím, dokončením, zrušením, uplynutím.
  • Odchylované kódy zůstanou k dispozici po zavření sesniny. Pro velké objemné použití REST /activations/{id}/sms s after_id.
  • Po čísle bez SMS je vymazán, getStatus a getSms Návrat STATUS_CANCEL; getSmsFull vrátí zavřený stav, prázdný telefon a prázdný sms a seznam . REST /activations/{id} a /sms Návrat 404 NO_ACTIVATION.
GETgetSmsSMS jako textový řetězec

Vrací celý historický text SMS ve formátu řetězce pro stávající klienty.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
id*integerID vašeho zasedání, které bylo obdržené po vydání čísla.

* Požadovaný parametr. ve všech požadavcích také projít akce =getSms.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42'

Odpovědi

poselství
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234
Čekání
STATUS_WAIT_CODE
Zrušení nebo uplynutí platnosti
STATUS_CANCEL
  • Formát zprávy: časový kód, text. Mnoho zpráv je odděleno kolónem.
  • Textové SMS může obsahovat kolony a vertikální pruhy. pro spolehlivé parsing použijte getSmsFull.
GETgetServicesSlužby

K dispozici jsou servisní kódy. Odpověď je omezena na oblast klíče API.

ředitelství

Publikování…

JSON ↗

Služební adresář je sdílen mezi dodavatelem. dostupnost čísla je ověřena samostatně.

Můžete omezit klíč na konkrétní služby, země a poskytovatele. prázdné seznamy umožňují všechny dostupné možnosti.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
countryintegerVzít ID od getCountries.

* Požadovaný parametr. ve všech požadavcích také projít akce =getServices.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY'

Odpovědi

Služby
{
  "go": {
    "name": "Google",
    "code": "go"
  }
}
  • Služební adresář je sdílen mezi dodavatelem. dostupnost čísla je ověřena samostatně.
GETgetCountriesZemě

ID, jména a volací kódy pro země v vybraném kanálu.

ředitelství

Publikování…

JSON ↗

Můžete omezit klíč na konkrétní služby, země a poskytovatele. prázdné seznamy umožňují všechny dostupné možnosti.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.

* Požadovaný parametr. ve všech požadavcích také projít akce =getCountries.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY'

Odpovědi

Země
{
  "86": {
    "id": 86,
    "name": "Italy",
    "phone_code": "39"
  }
}
GETgetOperatorsOperátory

Dostupní operátoři: API ID, název a doba zadržení odměny.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
countryintegerVzít ID od getCountries.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · any/0

* Požadovaný parametr. ve všech požadavcích také projít akce =getOperators.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY'

Odpovědi

Operátory
{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "operator=1",
    "earnings_hold_days": 45
  }
}
  • Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3.
GETgetRewardsOdměna za SMS

Cena závisí na zemi. Všechny tabulkové částky jsou za placené SMS.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
countryintegerVzít ID od getCountries.
servicestringK dispozici jsou servisní kódy. Odpověď je omezena na oblast klíče API.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · any/0

* Požadovaný parametr. ve všech požadavcích také projít akce =getRewards.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi'

Odpovědi

JSON
{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}
{}
{}
  • USD tarifní částky jsou vráceny jako přesné desáté řetězce s 8 desátými místy:
  • Nabídky jsou k dispozici pro váš klíč.
  • country ID → service code → operator ID → reward (USD)
GETgetTopCountriesByServiceТоп стран по сервису

До 10 стран с лучшей доставкой смс кодов за последние 24 часа

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.
service*stringКод сервиса из getServices.

* Požadovaný parametr. ve všech požadavcích také projít akce =getTopCountriesByService.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getTopCountriesByService&api_key=YOUR_API_KEY&service=go'

Odpovědi

Структура ответа

Ключ в примереPopisředitelství
["12"], ["36"]ID země
Первый, внешний уровень JSON. Каждая запись объединяет операторов одной страны.
getCountries
["12"]["1"], ["12"]["3"]ID оператора
Второй уровень JSON, внутри страны. Это публичный ID оператора (поставщика), который передаётся в параметре operator.
getOperators
JSON
{
  "12": {
    "1": {
      "reward": 0.012,
      "count": 542
    },
    "3": {
      "reward": 0.014,
      "count": 301
    }
  },
  "36": {
    "1": {
      "reward": 0.011,
      "count": 190
    }
  }
}
{}
{}
  • В примере ["12"]["1"] — данные оператора 1 в стране 12. ID стран берутся из getCountries, ID операторов — из getOperators.
  • reward — действующее личное вознаграждение в USD, JSON-число. count — количество выданных номеров за последние 24 часа, включая сессии без кода.
  • Рейтинг рассчитывается как все полученные непустые коды, делённые на все выдачи номеров за последние 24 часа для выбранного сервиса.
  • Повторные непустые коды увеличивают числитель; конверсия может превышать 100%. Начальные нули сохраняются.
  • Суточная статистика сервиса кэшируется на 10 минут. Тарифы и ограничения ключа проверяются при каждом запросе. Момент среза — в заголовке X-Statistics-As-Of.
  • Нет данных или доступных связок — пустой объект {}. Страны с выдачами и нулём кодов имеют нулевую конверсию. Порядок ключей JSON не задаёт места в рейтинге.
GETgetBalanceZůstatek uživatele

SMScash: dostupná rovnováha s ohledem na akruály, referenční bonusy a požadavky na platbu.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.

* Požadovaný parametr. ve všech požadavcích také projít akce =getBalance.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY'

Odpovědi

Zůstatek
ACCESS_BALANCE:0.00
  • getBalance vrací dostupnou rovnováhu USD s až 8 desetinovými místy.
  • Vybrat lze pouze prostředky, u kterých skončila čekací doba.
GETgetHoldBalancePozastaveno

Po přijetí SMS jsou výdělky pozastaveny na dobu stanovenou dodavatelem. V uvedený den se částka automaticky zpřístupní k výběru.

Parametry

ParametryTypPopis
api_key*stringOsobní API klíč uživatele.

* Požadovaný parametr. ve všech požadavcích také projít akce =getHoldBalance.

Příklad žádosti

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY'

Odpovědi

Pozastaveno
ACCESS_HOLD_BALANCE:34.50000001
  • SMScash · getHoldBalance · USD · 8
  • Vybrat lze pouze prostředky, u kterých skončila čekací doba.

Kód odpovědi a opakování žádostí

Vevnitř handler_api.php obchodní výsledky obvykle přijde s HTTP 200. Zkontrolujte tělový tekst. Zdroje a getSmsFull zpět JSON pokud je úspěšný; chyby jsou vždycky text.

KódHTTPPříčina a další krok
TARIFF_NOT_CONFIGURED200Ceny zatím neprovedlyPořadí počítá, jakmile bude SMS odměna nastavená.
COUNTRY_BLOCKED200Číslo přidělení pro tuto zemi je blokováno.Vyberte si jinou zemi.
BAD_SERVICE200Číslo přidělení pro tuto službu je blokováno.Vyberte si jinou službu.
PROVIDER_NOT_READY200Číslo přidělení je dočasně nedostupnéVydejte se do katalogů API.
BAD_KEY400Ne api_key nebo nevažný formát.Zkontrolujte klíč v žádosti.
INVALID_API_KEY401Klíč je neznámý, zrušený nebo účet je zrušen.Vytvořte si platný API klíč.
BAD_COUNTRY400Členské státy chybí nebo ne pozitivní číslo.Vzít ID od getCountries.
BAD_SESSION_DURATION400Telefonní čísla jsou vydávány přesně po dobu 20 minut.Správně session_duration.
BAD_REQUEST400Zkontrolujte požadavky na pole.Prosím, opravte prosím vaši žádost.
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER200Neznámé nebo zrušené položky adresáře.Vydejte se do katalogů API.
BAD_NUMBER200Nesprávný formát čísla.Vložte číslo v číslech.
BAD_ACTION / BAD_STATUS200Neznámá příkaz, ID nebo operace.Podívejte se na nastavení.
EMPTY_POOL200V současné době nejsou k dispozici žádné telefonní čísla.Opakujte po 10-30 Změna nebo změna filtru.
NUMBER_IN_USE200Jedno konkrétní číslo je obsazeno aktivní secí.Zrušit svůj účet nebo vyberte další číslo.
NO_ACTIVATION200Sezóna nebo předchozí číslo nepatří k vašemu účtu.Zkontrolujte ID a klíč.
SESSION_CLOSED / SMS_REQUIRED200V současné době není státní přechod k dispozici.Zkontrolujte stav a dostupnost SMS zpráv.
SCOPE_BLOCKED200Služba, země nebo dodavatel není oprávněn k klíči.Aktualizujte rozsah klíče API.
INTERNAL_ERROR500Způsoby chybějícího serveru nebo dodavatele.Kontakt a podpora · X-Request-ID
ALLOCATION_PENDING200ČekánígetActiveActivations · getStatus
ALLOCATION_UNCERTAIN200Výsledek přidělení není potvrzen. automatické odstupování je znemožněno, aby se zabránilo přidělování druhého čísla.Výsledek přidělení není potvrzen. automatické odstupování je znemožněno, aby se zabránilo přidělování druhého čísla.

Zbytek vrací předmět {"error":{"code":"…","message":"…"}} a pravidelné HTTP statuty 400/401/403/404/409/503.

JSON
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Zkontrolujte požadavky na pole.",
    "request_id": "req_…",
    "hint": "Use the documented JSON type; numbers must not be quoted.",
    "retryable": false,
    "details": {
      "field": "country",
      "expected": "integer"
    }
  }
}
REST
X-Request-ID: included in every API response
405: Allow lists the supported HTTP methods
ALLOCATION_PENDING: retryable=true · Retry-After=3 · same operation key
ALLOCATION_UNCERTAIN: retryable=false · contact support
Transport errors: check the operation before another write; keep the original key.

Zbývají nové integrace

USD tarifní částky jsou vráceny jako přesné desáté řetězce s 8 desátými místy: 0.00300000 USD.

Měna je USD. Schémata žádosti a odpovědi jsou k dispozici v OpenAPI.

Odstranění v USDT · TRC20Výplata trvá 1 až 45 dní. Poplatek za výběr je 4 $. Odečítá se z požadované částky. Po přijetí SMS jsou výdělky pozastaveny na dobu stanovenou dodavatelem. V uvedený den se částka automaticky zpřístupní k výběru. Vybrat lze pouze prostředky, u kterých skončila čekací doba.
GET/api/v1/catalogSlužby a země
GET/api/v1/tariffsSMS odměny podle země
GET/api/v1/offersCeny a odměny
GET/api/v1/servicesředitelství
GET/api/v1/countriesředitelství
GET/api/v1/operatorsředitelství
GET/api/v1/availability?country=1Dostupnost čísla
POST/api/v1/activationsNová zasedání
GET/api/v1/activations/batch?ids=42,43Ověřit více čísel
GET/api/v1/activationsPosledních 200 setkání: scope = historie, čekání nebo vše
GET/api/v1/activations/{id}Session a poselství
GET/api/v1/activations/{id}/sms?after_id=0&limit=100SMS s novým kurzorem
POST/api/v1/activations/{id}/retryČekání na SMS
POST/api/v1/activations/{id}/finishKompletní
POST/api/v1/activations/{id}/cancelZrušit
POST/api/v1/activations/repeatPočet návratů
GET/api/v1/keysAPI Klíče
POST/api/v1/keysVytvořte klíč
PATCH/api/v1/keys/{id}Změna názvu nebo politiky
DELETE/api/v1/keys/{id}Odvolání klíče
GET/api/v1/referralsReferenční kód a výnosy
GET/api/v1/summaryBalance a shrnutí
GET/api/v1/balancePozastaveno
GET/api/v1/ledgerZiskové ledgery
GET/api/v1/withdrawalsŽádosti o platbu
POST/api/v1/withdrawalsVytvořte žádost
GET/api/v1/statisticsCelková statistika
GET/api/v1/earnings/holdsPozastavení výdělků

Přijímání pouze nových SMS

REST
GET /api/v1/activations/42/sms?after_id=0&limit=100
Authorization: Bearer YOUR_API_KEY
JSON
{
  "session_id": 42,
  "sms": [
    {
      "id": 101,
      "code": "001234",
      "text": "Kód: 001234",
      "sender": "Service",
      "received_at": "2026-10-09T12:00:00Z"
    }
  ],
  "next_cursor": 101,
  "has_more": false
}

Zachránit next_cursor a předávám to jako after_id. Pokud has_more=true, další stránka může být okamžitě čtena. 1–200. Zasedení a SMS jsou k dispozici pouze pro vlastníku.