Čísla, zprávy a výnosy přímo z vaší aplikace.
SMScash
Dokumentace API
Začínat

Dokumentace API

Čísla, zprávy a výnosy přímo z vaší aplikace.

Začněte jedním požadavkem

13 · Ří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 20 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.
Rychlý start · REST / cURL
curl -X POST 'https://smscash.org/api/v1/activations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: request-unique-001' \
  -d '{"service":"go","country":86}'

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

REST API

Tvůrce požadavků

cURL · Go · JS · Python

Idempotency-Key: UUID · POST · 8–128

Automatický výběr: nejvíce kódů za poslední hodinu, pak za 24 hodin. Bez čísel: další operátor.

cURL
curl --max-time 15 --fail-with-body -X POST 'https://smscash.org/api/v1/activations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: request-unique-001' \
  --data '{"service":"go","country":86}'

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
REST
POST /api/v1/activations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: request-unique-001

{
  "service": "go",
  "country": 86
}

Automatický výběr: nejvíce kódů za poslední hodinu, pak za 24 hodin. Bez čísel: další operátor.

REST
201: new session · 200: replay of the same operation
service + country OR offer_id · duration_minutes: 20
ref: software owner code (optional)
operator: public ID (e.g. 1 for Operator 1), optional · any/0: automatic
country: integer · service: string · SMS code: string

Číslo je platné po dobu 20 minut. SMS je kontrolován každých 20 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": 20
}
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';
import {randomUUID} from 'node:crypto';

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

// Save this key before sending; keep it for retries of this operation.
const requestKey = randomUUID();
const session = await api.createNumber({service: 'go', country: 86}, requestKey);
// After 20 seconds:
const messages = await api.sms(session.id, {afterId: 0});
console.log(messages.sms);
const statuses = await api.batch([session.id]);
const held = await api.holdBalance();
console.log(held); // Exact USD string
Python 3.9+
import os
import uuid
from smscash import SmScash, SmScashError

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

# Save this key before sending; keep it for retries of this operation.
request_key = str(uuid.uuid4())
session = api.create_number({'service': 'go', 'country': 86}, request_key)
# After 20 seconds:
messages = api.sms(session['id'], after_id=0)
print(messages['sms'])
statuses = api.batch([session['id']])
held = api.hold_balance()
print(held) # Exact USD string
SDK
me() · balance() · holdBalance()/hold_balance() · catalog() · activation() · sms() · batch()
createNumber(parameters, requestKey) / create_number(parameters, request_key)
setStatus(id, "cancel") / set_status(id, "cancel")
setStatus(id, "retry", requestKey) / set_status(id, "retry", request_key)
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' \
  -H 'Idempotency-Key: request-unique-001'
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); 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.
Keep the original Idempotency-Key and parameters.
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 20 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 20 sekund. můžete okamžitě zrušit.

Zbytek, jedinečný Idempotency-Key je nutné pro přidělování čísel, opakování přidělování, odvolání a požadavky na platbu. je volitelné, ale doporučeno v handler_api.php. při odvolání požadavku na síť znovu použijte klíč; použijte nový klíč pro novou operaci.

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.
operatorstringVzít ID od operators/getOperators (API). operator=1 · 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.
refstringVeřejný kód majitele softwaru: 5% pro něj a 5% pro hostitele. bez ref - 10% pro hostitele.

* 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' \
  -H 'Idempotency-Key: request-unique-001'

Odpovědi

vydané číslo
ACCESS_NUMBER:42:380670000000:1
Žádné dostupné čísla
EMPTY_POOL
  • Automatický výběr: nejvíce kódů za poslední hodinu, pak za 24 hodin. Bez čísel: další operátor.
  • Prochází Idempotency-Key: stejné žádosti s stejným klíčem vrátí předchozí sesce. Změní parametrů zavolání IDEMPOTENCY_CONFLICT.
  • Čí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' \
  -H 'Idempotency-Key: request-unique-001'

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í.
  • pro status =3 Použití Idempotency-Key: opakování žádosti nebude znovu nastaven nový kód již obdržený. SMS Zůstává k dispozici.
  • 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.
refstringVeřejný kód majitele softwaru: 5% pro něj a 5% pro hostitele. bez ref - 10% pro hostitele.
operatorstringVzít ID od operators/getOperators (API). operator=1 · 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' \
  -H 'Idempotency-Key: request-unique-001'

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": "Оператор 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.

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.

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.
operatorstringVzít ID od operators/getOperators (API). operator=1 · 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": "Оператор 1",
    "earnings_hold_days": 45
  }
}
  • Vzít ID od operators/getOperators (API).
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.
operatorstringVzít ID od operators/getOperators (API). operator=1 · 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)
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_REQUEST400Nepodležný parameter nebo Idempotency-Key.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.
IDEMPOTENCY_CONFLICT200Tento klíč dotazů je již spojen s dalšími parametry.Pro novou operaci vytvořte další Idempotency-Key.
BAD_REF / SELF_REF400Kód softwaru je neznámý, zrušený nebo patří samotnému uživatelovi.Zadejte kód vlastníka softwaru.
INTERNAL_ERROR500Způsoby chybějícího serveru nebo dodavatele.Znovu s odpovídajícím a stejném Idempotency-Key.
ALLOCATION_PENDING200Vstup do práce je v plném rozsahu.Retry s stejným Idempotency-Key.Vstup do práce je v plném rozsahu.Retry s stejným Idempotency-Key.
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.