Čísla, správy a výnosy priamo z aplikácie.
SMScash
API dokumentácia
Začať sa

API dokumentácia

Čísla, správy a výnosy priamo z aplikácie.

Začnite s jedným žiadosťou

13 · API príkazovREST + handler_api.phpJSON / plain text · Bearer

Vytvorte kľúč API vo vašej tabuľke, získajte číslo a skontrolujte správy každých 20 sekúnd.Platba je kreditovaná, keď SMS s kódom prichádza; čítanie znova neovplyvňuje váš bilanciu.

REST APIhttps://smscash.org/api/v1
Základné URL APIhttps://smscash.org/stubs/handler_api.php
Služba je živátelefónne čísla , SMS Zisk je k dispozícii, výnosy sú k dispozícií USDT na TRC20Platby sa medzi 1 a 45 Dni sú.
Rýchly štart · 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}'

Alternatívna kompatibilná rozhranie adresa: /handler_api.php. Existujúce integrácie REST pokračujú v práci.

REST API

Tvorca požiadaviek

cURL · Go · JS · Python

Idempotency-Key: UUID · POST · 8–128

Automatický výber: najviac kódov za poslednú hodinu, potom za 24 hodín. Bez čísel: ďalší 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}'

Kľúč sa neukladá. Toto overenie neprideľuje čísla.

Zostáva pre nové integrácie

Služby a krajiny

Vyberte si službu a krajinu. platba SMS závisí od krajiny.

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ískajte čí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ýber: najviac kódov za poslednú hodinu, potom za 24 hodín. Bez čísel: ďalší 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é 20 minút. SMS sa kontroluje každých 20 sekúnd.

Overiť viac čí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
Zostatok · Pozastavené
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 — Pozastavené. USD · 8

Vybrať možno len prostriedky, ktorých čakacia lehota už uplynula.

Klienti pripravení na použitie

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 kľúč používateľa.

Vyberte si službu a krajinu. platba SMS závisí od krajiny.

KódPopis
getNumber / getNumberV2Získajte číslo
getStatus / getStatusV2Získajte najnovší kód
setStatus / finishActivation / cancelActivationriadenie zasadnutia
getPrices / getNumbersStatuskontrolovať dostupnosť
getRewards (SMScash)Odmeny za SMS
getServicesList / getServicesSlužby
getCountries / getOperatorsSlužby a krajiny
getActiveActivationszasadnutia
getBalanceZostatok používateľa
getHoldBalance (SMScash)Pozastavené

cost = 0 USD · activationCost = 0 USD
reward — Odmeny 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'
Odpoveď
{
  "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é 20 minút. SMS sa kontroluje každých 20 sekúnd.

Autentika a odchýlky

REST: HEDER Authorization: Bearer YOUR_API_KEY. kompatibilný rozhranie : parametre api_key a actionPoužite HTTPS

Ak chcete spravovať kľúče API, zadajte svoj účet.

∞Požiadavky / min na účet
∞Súčasné zasadnutia

Častota požiadaviek API a počet telefónnych čísel sú neobmedzené.Neexistujú denné alebo hodinové kvóty.

Číslo je platné 20 minút. SMS sa kontroluje každých 20 sekúnd.

Zvyšok, jedinečný Idempotency-Key je potrebné na pridelenie čísel, opakovanie pridelenia, odovzdanie a platobné žiadosti. je to voliteľné, ale odporúča sa v handler_api.php. Opakovanie kľúča pri odovzdaní požiadavky siete; používať nový kľúč pre novú operáciu.

API kľúčové rozsah

Kľúč môžete obmedziť na konkrétne služby, krajiny a poskytovateľov. prázdne zoznamy umožňujú všetky dostupné možnosti.

JSON
{
  "label": "Môj softvér",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} mení názov a politiku úplne. tajomstvo sa ukazuje len vtedy, keď je vytvorené.

10% v celkovom. 5% + 5% s softvérovým kódom.

Pri vydávaní čísla, prosím, poskytnite ref majiteľ softvéru. žiadosť je povolená kľúčom výkonu. kód je v časti "Referrals" a v GET /api/v1/referrals → software_ref.

žiadosťpozvánkasoftvér
Bez ref10%—
s ref5%5%
s ref, bez referera—5%

Platba platby platby bez zníženia príjmov používateľa. majiteľ softvéru a referer môže byť rovnaká osoba.

Termíny sú stanovené, keď je vytvorená relácia; čítanie SMS a odchod sa nezmení. Prejdite ref znova pre novú reláciu opakovania. V výpočte sadzieb, používateľ odmeny USD 0.003 dáva USD 0.00015 každý majiteľ softvéru a referer. Celkový bonus je USD 0.00030.

API príkazov

11 XVBC štýlové metódy plus váš SMScash rovnováha.

GETgetNumberZískajte číslo

Vytvára sa relácia a uchováva sa pre používateľov dostupné číslo.Razmery a referenčné príjemcovia sú fixované na pridelení; odmeny sa kreditujú, keď príde SMS s kódom.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.
service*stringK dispozícii sú služby kódov. Odpoveď je obmedzená na oblasť kľúča API.
country*integerVezmite ID od getCountries.
operatorstringVezmite ID od operators/getOperators (API). operator=1 · any/0
session_durationintegerZáverečná doba trvá 20 minút. prejdite 20 alebo omylom tento parameter.
with_operatorinteger1 pridá do odpovede ID operátora; 0 alebo vynechaný parameter vráti tri časti.
refstringVerejný kód majiteľa softvéru: 5% pre neho a 5% pre hostiteľa. bez ref - 10% pre hostiteľa.

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getNumber.

Príklad žiadosti

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'

Odpoveď

vydané číslo
ACCESS_NUMBER:42:380670000000:1
Žiadne dostupné čísla
EMPTY_POOL
  • Automatický výber: najviac kódov za poslednú hodinu, potom za 24 hodín. Bez čísel: ďalší operátor.
  • Pasáž Idempotency-Key: rovnaká žiadosť s rovnakým kľúčom vráti predchádzajúcu reláciu. IDEMPOTENCY_CONFLICT.
  • Číselná krajina bez bazénu dáva EMPTY_POOL; nesprávny formát krajiny je BAD_COUNTRY.
  • Kľúč odstránenej relácie zostáva použitý: prehrávanie pridelenia s týmto kľúčom vráti SESSION_CLOSED a nevydáva ďalšie číslo.
  • Výsledok pridelenia nie je potvrdený. Automatické odovzdanie je zakázané, aby sa zabránilo pridelení druhého čísla.
GETgetNumbersStatuskontrolovať dostupnosť

Dostupné telefónne čísla podľa služby a krajiny.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.
country*integerVezmite ID od getCountries.

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getNumbersStatus.

Príklad žiadosti

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

Odpoveď

Dostupné čísla
{
  "go_0": 0
}
  • _0 suffix znamená voľbu bez konkrétneho operátora.
  • Dostupnosť sa vzťahuje na celkový bazén dodávateľa.Vybraný kanál sa skontroluje, keď je pridelený počet.
GETgetStatusZískajte najnovší kód

Jednoduché požiadavky na stav schôdze a posledný SMS kód. Vedúce zerá v kóde sú zachované.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.
id*integerID vašej schôdze, ktorý ste dostali, keď bol vydaný číslo.

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getStatus.

Príklad žiadosti

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

Odpoveď

Čakajúci
STATUS_WAIT_CODE
Kód prijímaný
STATUS_OK:001234
Zrušenie alebo uplynutie lehoty
STATUS_CANCEL
nenájdené
NO_ACTIVATION
  • Poll každých 20 sekúnd. čítanie správy znovu nevytvára ďalšiu platbu.
  • Po retry Starý kód sa nevráti: getStatus Čakajte na ďalšiu SMS.
  • Po čísle bez SMS je odstránený , getStatus a getSms Návrat STATUS_CANCEL; getSmsFull vráti zatvorený stav, prázdny telefón a prázdny sms Zoznam → REST /activations/{id} a /sms Návrat 404 NO_ACTIVATION.
GETsetStatusriadenie zasadnutia

Končí, zruší alebo obnoví čakanie na SMS.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.
id*integerID vašej schôdze, ktorý ste dostali, keď bol vydaný číslo.
status*integer3 - počkať na ďalší kód bez predĺženia zasadnutia; 6 - dokončiť po SMS; 8 - okamžite zrušiť.

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =setStatus.

Príklad žiadosti

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'

Odpoveď

Čakajú na SMS
ACCESS_RETRY_GET
dokončený
ACCESS_ACTIVATION
zrušené
ACCESS_CANCEL
  • Vrátenie čaká na ďalší kód v pôvodných 20 minút. Výstup a časy uplynutia sa nezmenia.
  • Pre stav =3 Použitie Idempotency-Key: opakovanie žiadosti nebude obnoviť nový kód už prijatý. SMS Zostáva k dispozícii.
  • Zrušením sa nezruší už zarobené odmeny.
  • V histórii sa uchovávajú iba čísla s kódom SMS. Zrušené a uplynuté čísla bez kódu sa odstránia.
GETgetRepeatNumberZnova si vyberajte rovnaké číslo

Otvorte novú reláciu s konkrétnym číslom z vašej histórie.Môžete vybrať inú dostupnú službu v rovnakej krajine.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.
number*stringVaše staré číslo. len čísla a voliteľný vedúci + sú povolené.
service*stringK dispozícii sú služby kódov. Odpoveď je obmedzená na oblasť kľúča API.
session_durationintegerZáverečná doba trvá 20 minút. prejdite 20 alebo omylom tento parameter.
with_operatorinteger1 pridá do odpovede ID operátora; 0 alebo vynechaný parameter vráti tri časti.
refstringVerejný kód majiteľa softvéru: 5% pre neho a 5% pre hostiteľa. bez ref - 10% pre hostiteľa.
operatorstringVezmite ID od operators/getOperators (API). operator=1 · any/0

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getRepeatNumber.

Príklad žiadosti

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'

Odpoveď

Nová schôdza
ACCESS_NUMBER:43:380670000000
Číslo je stále zaneprázdnené
NUMBER_IN_USE
  • Po prvé, ukončiť alebo zrušiť aktuálnu reláciu. Ak je číslo zaneprázdnené, re-exuancia sa nevykonáva.
  • Nová relácia dostane nový ID a aktuálny poplatok. staré SMS nie sú kopírované. ref je nastavený znova.
  • SMScash umožňuje opakovať iba čísla z histórie tohto účtu.
  • Kľúč odstránenej relácie zostáva použitý: prehrávanie pridelenia s týmto kľúčom vráti SESSION_CLOSED a nevydáva ďalšie číslo.
GETgetSmsFullSMS ako JSON

Štruktúrovaná história všetkých správ s ID, odosielateľ, kód, text a krajina, služba a údaje o dodávateľoch.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.
id*integerID vašej schôdze, ktorý ste dostali, keď bol vydaný číslo.

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getSmsFull.

Príklad žiadosti

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

Odpoveď

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"
}
  • Preferovaný formát pre integráciu. Pamätajte si SMS[].id spracovať iba nové správy.
  • Numerický stav SMScash: 1 - aktívny, 6 - dokončený, 8 - zrušený alebo uplynul. status_name rozlišuje medzi čakaním, prijatím, dokončením, zrušením, uplynulím.
  • Dostupné kódy zostávajú k dispozícii po ukončení relácie. pre veľké objemy použite REST /activations/{id}/sms s after_id.
  • Po čísle bez SMS je odstránený , getStatus a getSms Návrat STATUS_CANCEL; getSmsFull vráti zatvorený stav, prázdny telefón a prázdny sms Zoznam → REST /activations/{id} a /sms Návrat 404 NO_ACTIVATION.
GETgetSmsSMS ako textový pruh

Vráti celý príbeh SMS v riadkovom formáte pre existujúcich klientov.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.
id*integerID vašej schôdze, ktorý ste dostali, keď bol vydaný číslo.

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getSms.

Príklad žiadosti

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

Odpoveď

Posolstvo
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234
Čakajúci
STATUS_WAIT_CODE
Zrušenie alebo uplynutie lehoty
STATUS_CANCEL
  • Formát správy: časový kód a text. Mnohé správy sú oddelené kolónou.
  • Text sa SMS môže obsahovať kolóny a vertikálne pruhy. pre spoľahlivé paršovanie, používať getSmsFull.
GETgetServicesSlužby

K dispozícii sú služby kódov. Odpoveď je obmedzená na oblasť kľúča API.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.
countryintegerVezmite ID od getCountries.

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getServices.

Príklad žiadosti

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

Odpoveď

Služby
{
  "go": {
    "name": "Google",
    "code": "go"
  }
}
  • Služobný adresár je zdieľaný v rámci dodávateľa. dostupnosť čísla sa kontroluje samostatne.
GETgetCountriesKrajiny

ID, mená a volací kódy pre krajiny v vybranom kanáli.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getCountries.

Príklad žiadosti

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

Odpoveď

Krajiny
{
  "86": {
    "id": 86,
    "name": "Italy",
    "phone_code": "39"
  }
}
GETgetOperatorsOperátorov

Dostupní operátori: API ID, názov a doba zadržania odmeny.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.
countryintegerVezmite ID od getCountries.
operatorstringVezmite ID od operators/getOperators (API). operator=1 · any/0

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getOperators.

Príklad žiadosti

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

Odpoveď

Operátorov
{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}
  • Vezmite ID od operators/getOperators (API).
GETgetRewardsOdmeny za SMS

Zásady závisia od krajiny. Všetky tabuľkové sumy sú za platené SMS.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.
countryintegerVezmite ID od getCountries.
servicestringK dispozícii sú služby kódov. Odpoveď je obmedzená na oblasť kľúča API.
operatorstringVezmite ID od operators/getOperators (API). operator=1 · any/0

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getRewards.

Príklad žiadosti

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

Odpoveď

JSON
{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}
{}
{}
  • USD sa vrátia ako presné desiatkové pruhy s 8 desiatkami:
  • Povolené poskytovatelia k dispozícii pre váš kľúč.
  • country ID → service code → operator ID → reward (USD)
GETgetBalanceZostatok používateľa

SMScash: dostupná bilancia s prihliadnutím na akruály, referenčné bonusy a platobné žiadosti.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getBalance.

Príklad žiadosti

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

Odpoveď

Zostatok
ACCESS_BALANCE:0.00
  • getBalance vráti dostupné USD rovnováha s až do 8 desiatky miesta.
  • Vybrať možno len prostriedky, ktorých čakacia lehota už uplynula.
GETgetHoldBalancePozastavené

Po prijatí SMS sa zárobky pozastavia na obdobie určené dodávateľom. V uvedený deň sa suma automaticky sprístupní na výber.

Parametre

ParametretypyPopis
api_key*stringOsobný API kľúč používateľa.

* Požadovaný parameter.V každej žiadosti sa tiež uskutočňuje akcia =getHoldBalance.

Príklad žiadosti

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

Odpoveď

Pozastavené
ACCESS_HOLD_BALANCE:34.50000001
  • SMScash · getHoldBalance · USD · 8
  • Vybrať možno len prostriedky, ktorých čakacia lehota už uplynula.

Kód odpovede a opakovanie žiadostí

v handler_api.php obchodné výsledky zvyčajne prichádzajú s HTTP 200Pozrite sa na text tela. smernice a getSmsFull Návrat JSON Ak sa to stane, chyby sú vždy text.

KódHTTPPríčina a ďalší krok
TARIFF_NOT_CONFIGURED200Záväzky sa zatiaľ neuplatňujúČíslo pridelenia sa začne, keď SMS odmeny sú nastavené.
COUNTRY_BLOCKED200Číslo pridelenia pre túto krajinu je zablokované.Vyberte si inú krajinu.
BAD_SERVICE200Číslo pridelenia na túto službu je zablokované.Vyberte si inú službu.
PROVIDER_NOT_READY200Číslo pridelenia je dočasne nedostupnéOdstráňte katalóg API.
BAD_KEY400Nie api_key alebo neplatný formát.Pozrite sa na kľúč v žiadosti.
INVALID_API_KEY401Kľúč je neznámy, zrušený alebo účet je vypnutý.Vytvorte platný kľúč API.
BAD_COUNTRY400Či už chýba alebo nie je pozitívna hodnota.Vezmite ID od getCountries.
BAD_SESSION_DURATION400Telefónne čísla sú vydané presne 20 minút.správne session_duration.
BAD_REQUEST400Invalidný parameter alebo Idempotency-Key.Prosím, opravte vašu žiadosť.
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER200Neznámy alebo zneužívaný položka adresára.Odstráňte katalóg API.
BAD_NUMBER200Nesprávne číslo formátu.Zadajte číslo v číslach.
BAD_ACTION / BAD_STATUS200Neznámy príkaz, ID alebo operácia.Pozrite sa na nastavenia.
EMPTY_POOL200V súčasnosti nie sú k dispozícii žiadne zodpovedajúce telefónne čísla.Opakujte po 10-30 sekúnd alebo zmeniť filtre.
NUMBER_IN_USE200Jedno konkrétne číslo je obsadené aktívnou reláciou.Záverečný termín alebo vyberte ďalšie číslo.
NO_ACTIVATION200Predchádzajúce číslo alebo číslo sa nezúčastňuje vášho účtu.Pozrite si ID a kľúč.
SESSION_CLOSED / SMS_REQUIRED200Prechod štátov je v súčasnosti nedostupný.Pozrite sa na podmienky a dostupnosť SMS.
SCOPE_BLOCKED200Služba, krajina alebo dodávateľ nie je oprávnený na kľúč.Aktualizácia rozsahu kľúča API.
IDEMPOTENCY_CONFLICT200Tento klávesový dotaz je už spojený s inými parametrami.Pre novú operáciu vytvorte ďalší Idempotency-Key.
BAD_REF / SELF_REF400Kód softvéru je neznámy, nezrušený alebo patrí samotnému používateľovi.Upozorňujeme na kód majiteľa softvéru.
INTERNAL_ERROR500Dočasná chyba servera alebo predávajúceho.Opakujte s oneskorením a to isté Idempotency-Key.
ALLOCATION_PENDING200Číslo pridelenie je už v procese. návrat s rovnakým Idempotency-Key.Číslo pridelenie je už v procese. návrat s rovnakým Idempotency-Key.
ALLOCATION_UNCERTAIN200Výsledok pridelenia nie je potvrdený. Automatické odovzdanie je zakázané, aby sa zabránilo pridelení druhého čísla.Výsledok pridelenia nie je potvrdený. Automatické odovzdanie je zakázané, aby sa zabránilo pridelení druhého čísla.

Zvyšok vracia objekt {"error":{"code":"…","message":"…"}} a pravidelné HTTP štatúty 400/401/403/404/409/503.

JSON
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Pozrite si polia žiadosti.",
    "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.

Zostáva pre nové integrácie

USD sa vrátia ako presné desiatkové pruhy s 8 desiatkami: 0.00300000 USD.

Balíková mena je USD. Schémy žiadosti a odpovede sú k dispozícii v OpenAPI.

Odstránenie v USDT · TRC20Výplaty trvajú 1 až 45 dní. Poplatok za výber je 4 $. Odpočíta sa z požadovanej sumy. Po prijatí SMS sa zárobky pozastavia na obdobie určené dodávateľom. V uvedený deň sa suma automaticky sprístupní na výber. Vybrať možno len prostriedky, ktorých čakacia lehota už uplynula.
GET/api/v1/catalogSlužby a krajiny
GET/api/v1/tariffsSMS odmeny podľa krajiny
GET/api/v1/offerssadzby a odmeny
GET/api/v1/servicesriaditeľka
GET/api/v1/countriesriaditeľka
GET/api/v1/operatorsriaditeľka
GET/api/v1/availability?country=1Dostupnosť čísla
POST/api/v1/activationsNová schôdza
GET/api/v1/activations/batch?ids=42,43Overiť viac čísel
GET/api/v1/activationsPosledných 200 zasadnutí: rozsah = história, čakanie alebo všetko
GET/api/v1/activations/{id}Sedenie a správy
GET/api/v1/activations/{id}/sms?after_id=0&limit=100SMS s kurzorom
POST/api/v1/activations/{id}/retryČakajú na SMS
POST/api/v1/activations/{id}/finishdokončenie
POST/api/v1/activations/{id}/cancelZrušiť
POST/api/v1/activations/repeatčíslo návrat
GET/api/v1/keysAPI Kľúč
POST/api/v1/keysVytvorte kľúč
PATCH/api/v1/keys/{id}Zmena názvu alebo politiky
DELETE/api/v1/keys/{id}Odvolanie kľúča
GET/api/v1/referralsReferenčný kód a príjmy
GET/api/v1/summaryBalancia a súhrn
GET/api/v1/balancePozastavené
GET/api/v1/ledgerZiskové lístky
GET/api/v1/withdrawalsPlatobné žiadosti
POST/api/v1/withdrawalsVytvorte žiadosť
GET/api/v1/statisticsCelková štatistika
GET/api/v1/earnings/holdsPozastavenie zárobkov

Dostávame iba nové 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ániť next_cursor a prejsť na ako after_idAk has_more=trueĎalšiu stránku si môžete prečítať okamžite. limit: 1–200- zasadnutia a SMS Sú k dispozícii len majiteľovi.