Brojevi, poruke i zarade, izravno iz vaše aplikacije.
SMScash
API dokumentacija
Početak

API dokumentacija

Brojevi, poruke i zarade, izravno iz vaše aplikacije.

Počnite s jednim zahtjevom

13 · API zapovijediREST + handler_api.phpJSON / plain text · Bearer

Stvorite API ključ u vašem dashboard, dobijte broj i provjerite poruke svakih 20 sekundi.Plaćanje se kreditira kada SMS s kodom stiže; čitanje ga ponovno ne utječe na vašu ravnotežu.

REST APIhttps://smscash.org/api/v1
Usklađenost API bazni URLhttps://smscash.org/stubs/handler_api.php
Služba je živabroj telefona , SMS i dobit je dostupna. povlačenja su dostupna u USDT na TRC20Plaćanja se uzimaju između 1 i 45 Danima je.
Brz početak · 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}'

Alternativna kompatibilna adresa su: /handler_api.php. postojeći REST integracije i dalje rade.

REST API

Izrada zahtjeva

cURL · Go · JS · Python

Idempotency-Key: UUID · POST · 8–128

Automatski odabir: najviše kodova u posljednjem satu, zatim u 24 sata. Nema brojeva: sljedeći operater.

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}'

Ključ se ne pohranjuje. Ova provjera ne dodjeljuje brojeve.

Ostalo za nove integracije

Usluge i zemlje

Izaberite uslugu i zemlju. plaćanje putem SMS-a ovisi o zemlji.

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)

Dobijte broj
REST
POST /api/v1/activations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: request-unique-001

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

Automatski odabir: najviše kodova u posljednjem satu, zatim u 24 sata. Nema brojeva: sljedeći operater.

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

Broj je valjan 20 minuta. SMS se provjerava svakih 20 sekundi. možete odmah otkazati.

Provjeri više brojeva
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
Stanje · Zadržano
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 — Dostupno; held_balance — Zadržano. USD · 8

Mogu se isplatiti samo sredstva kojima je završilo razdoblje zadržavanja.

Klijenti spremni za uporabu

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 · Usklađenost API bazni URLhttps://smscash.org/sms-activate/stubs/handler_api.php
HeroSMS · Usklađenost API bazni URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Osobni API ključ korisnika.

Izaberite uslugu i zemlju. plaćanje putem SMS-a ovisi o zemlji.

KodoviOpis
getNumber / getNumberV2Dobijte broj
getStatus / getStatusV2Dobijte najnovije kodove
setStatus / finishActivation / cancelActivationUpravljanje sjednicama
getPrices / getNumbersStatusProvjerite dostupnost
getRewards (SMScash)Nagrada za SMS
getServicesList / getServicesUsluge
getCountries / getOperatorsUsluge i zemlje
getActiveActivationsSjednice
getBalanceStanje korisnika
getHoldBalance (SMScash)Zadržano

cost = 0 USD · activationCost = 0 USD
reward — Nagrada 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'
Odgovori
{
  "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.

Broj je valjan 20 minuta. SMS se provjerava svakih 20 sekundi. možete odmah otkazati.

Autentifikacija i povlačenje

REST: Naslovnica Authorization: Bearer YOUR_API_KEY. Kompatibilni su interfejsi: parametri api_key i actionKoristite HTTPS

Da biste upravljali API ključima, unesite svoj račun.

∞Zahtjevi / min po računu
∞Istodobne sjednice

API zahtijeva frekvenciju i broj telefonskih brojeva su neograničeni. nema dnevnih ili satnih kvota.

Broj je valjan 20 minuta. SMS se provjerava svakih 20 sekundi. možete odmah otkazati.

U ostalim, jedinstvenim Idempotency-Key Potrebno je za dodjelu broja, ponoviti dodjelu, zahtjev za povlačenje i plaćanje. to je opcionalno, ali preporučuje se u handler_api.php. Ponovno koristiti ključ prilikom povlačenja mrežne zahtjeve; koristite novi ključ za novu operaciju.

API ključni raspon

Možete ograničiti ključ na određene usluge, zemlje i pružatelje. prazne popise omogućuju sve dostupne opcije.

JSON
{
  "label": "Moj softver",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} Promijenite ime i politiku u potpunosti. tajna se pokazuje samo kada je stvorena.

10% u ukupnom. 5% + 5% sa softverskim kodom.

Kada izdati broj, molimo dajte ref vlasnik softvera. zahtjev je ovlašten ključem izvršitelja. kod je u odjeljku "Referral" i u GET /api/v1/referrals → software_ref.

zahtjevPozivsoftver
Bez ref10%—
S ref5%5%
S ref, bez referera—5%

Platforma plaća bonus bez smanjenja zarade korisnika. vlasnik softvera i referer mogu biti ista osoba. korisnik ne može koristiti svoj kod.

Uvjeti su fiksirani kada se stvori sjednica; čitanje SMS-a i povlačenje ih ne mijenjaju. Prođite ref ponovno za novu ponavljanu sjednicu. U izračunu tarifa, korisnik nagrada od USD 0.003 daje USD 0.00015 svaki vlasniku softvera i referer. Ukupni bonus je USD 0.00030.

API zapovijedi

11 XVBC-stila metoda plus vaš SMScash ravnoteža.

GETgetNumberDobijte broj

Stvara se sjednica i rezervira broj koji je dostupan za korisnika. nagrada i referralni primatelji su fiksni na dodjeli; nagrada se kreditira kada SMS s kodom stiže.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.
service*stringDostupni servisni kodi.Odgovor je ograničen na područje API ključa.
country*integerUzmi ID od getCountries.
operatorstringUzmi ID od operators/getOperators (API). operator=1 · any/0
session_durationintegerSesija traje 20 minuta. proći 20 ili propustiti ovaj parametar.
with_operatorinteger1 dodaje ID operatera u odgovor; 0 ili izostavljen parametar vraća tri dijela.
refstringJavni kod vlasnika softvera: 5% za njega i 5% za goste. bez ref - 10% za goste.

* Potrebni parametri. u svim zahtjevima također prođe akcija=getNumber.

Primjer zahtjeva

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'

Odgovori

Izdan broj
ACCESS_NUMBER:42:380670000000:1
Nema dostupnih brojeva
EMPTY_POOL
  • Automatski odabir: najviše kodova u posljednjem satu, zatim u 24 sata. Nema brojeva: sljedeći operater.
  • Prolaz Idempotency-Key: isti zahtjev sa istim ključom vraćaju prethodnu sesiju. Promijenje parametra poziva IDEMPOTENCY_CONFLICT.
  • Brojna zemlja bez bazena daje EMPTY_POOL; pogrešan format zemlje je BAD_COUNTRY.
  • Klavir za uklonjenu sjednicu ostaje upotrijebljen: ponovna raspodjela s tim ključem vraća SESSION_CLOSED i ne izda drugi broj.
  • Rezultati dodjele nisu potvrđeni. automatski povlačenje je onemogućeno kako bi se izbjeglo dodjelu drugog broja.
GETgetNumbersStatusProvjerite dostupnost

Dostupni broj telefona po službi i zemlji.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.
country*integerUzmi ID od getCountries.

* Potrebni parametri. u svim zahtjevima također prođe akcija=getNumbersStatus.

Primjer zahtjeva

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

Odgovori

Dostupni brojevi
{
  "go_0": 0
}
  • _0 suffix znači izbor bez određenog operatera.
  • Dostupnost se odnosi na ukupni bazen dobavljača.Odabran kanal se provjerava kada se dodjeljuje broj.
GETgetStatusDobijte najnovije kodove

Jednostavna zahteva za status sjednice i posljednji SMS kod. Čuvani su vodeći zerovi u kodu.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.
id*integerID sjednice, primljen kada je izdan broj.

* Potrebni parametri. u svim zahtjevima također prođe akcija=getStatus.

Primjer zahtjeva

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

Odgovori

Čekanje
STATUS_WAIT_CODE
Kod primljen
STATUS_OK:001234
otkazivanje ili isteak
STATUS_CANCEL
Ne pronađeno
NO_ACTIVATION
  • Poll svaki 20 Čitanje poruke ponovno ne stvara novu plaćanje.
  • Poslije retry stari kod nije vraćeni: getStatus čeka na sljedeću SMS.
  • Nakon broja bez SMS i uklonjen je, getStatus i getSms povratak STATUS_CANCEL; getSmsFull vraća zatvoren status, prazan telefon i prazan sms Na popisu. REST /activations/{id} i /sms povratak 404 NO_ACTIVATION.
GETsetStatusUpravljanje sjednicama

Završava, otkaže ili ponovno čeka SMS.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.
id*integerID sjednice, primljen kada je izdan broj.
status*integer3 – čekati sljedeći kod bez produljenja sjednice; 6 – završiti nakon SMS-a; 8 – odmah otkazati.

* Potrebni parametri. u svim zahtjevima također prođe akcija=setStatus.

Primjer zahtjeva

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'

Odgovori

Čekajući SMS
ACCESS_RETRY_GET
Završeno
ACCESS_ACTIVATION
otkazano
ACCESS_CANCEL
  • Povratak čeka sljedeći kod u roku od 20 minuta. izlazak i vremenski uvjeti ne mijenjaju se.
  • Za status =3 korištenje Idempotency-Key: ponavljanje zahtjeva neće ponovno postaviti novi kod koji je već primljen. SMS Ostaje dostupna
  • Otkaz ne uklanja nagrade koje su već zaradili.
  • Samo brojevi s SMS kodom čuvaju se u povijesti. otkazani i istekli brojevi bez koda brišu se.
GETgetRepeatNumberPonovno iskoristite isti broj

Otvorite novu sjednicu s određenim brojem iz povijesti. možete odabrati još jednu dostupnu uslugu u istoj zemlji.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.
number*stringSamo brojevi i opcionalni voditelj + dopušteni su.
service*stringDostupni servisni kodi.Odgovor je ograničen na područje API ključa.
session_durationintegerSesija traje 20 minuta. proći 20 ili propustiti ovaj parametar.
with_operatorinteger1 dodaje ID operatera u odgovor; 0 ili izostavljen parametar vraća tri dijela.
refstringJavni kod vlasnika softvera: 5% za njega i 5% za goste. bez ref - 10% za goste.
operatorstringUzmi ID od operators/getOperators (API). operator=1 · any/0

* Potrebni parametri. u svim zahtjevima također prođe akcija=getRepeatNumber.

Primjer zahtjeva

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'

Odgovori

Nova sjednica
ACCESS_NUMBER:43:380670000000
Broj je još uvijek zauzet
NUMBER_IN_USE
  • Prvo, završite ili otkazujte trenutnu sjednicu.Ako je broj zauzet, ponovna izlaska se ne izvodi.
  • Nova sjednica dobiva novi ID i trenutni tarif. stari SMS se ne kopira u njega. ref se ponovno postavlja.
  • SMScash omogućuje ponavljanje samo brojeva iz povijesti ovog računa.
  • Klavir za uklonjenu sjednicu ostaje upotrijebljen: ponovna raspodjela s tim ključem vraća SESSION_CLOSED i ne izda drugi broj.
GETgetSmsFullSMS poruka kao JSON

Struktura povijest svih poruka s ID, pošiljatelj, kod, tekst i zemlja, usluga i podaci o dobavljaču.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.
id*integerID sjednice, primljen kada je izdan broj.

* Potrebni parametri. u svim zahtjevima također prođe akcija=getSmsFull.

Primjer zahtjeva

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

Odgovori

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"
}
  • Preferirani format za integraciju. zapamtite SMS[].id da biste obrađivali samo nove poruke.
  • Numerski status SMScash: 1 - aktivan, 6 - završena, 8 - otkazana ili istekla. status_name razlikuje između čekanja, primanja, završetka, otkazivanja, isteka.
  • Primljene šibe ostaje dostupne nakon zatvaranja sesije. Za velike volume, koristite REST /activations/{id}/sms s after_id.
  • Nakon broja bez SMS i uklonjen je, getStatus i getSms povratak STATUS_CANCEL; getSmsFull vraća zatvoren status, prazan telefon i prazan sms Na popisu. REST /activations/{id} i /sms povratak 404 NO_ACTIVATION.
GETgetSmsSMS kao tekst string

Povratak cijele povijesti SMS-a u formatu struka za postojeće klijente.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.
id*integerID sjednice, primljen kada je izdan broj.

* Potrebni parametri. u svim zahtjevima također prođe akcija=getSms.

Primjer zahtjeva

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

Odgovori

poruka
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234
Čekanje
STATUS_WAIT_CODE
otkazivanje ili isteak
STATUS_CANCEL
  • Format poruke: vrijeme, kod, tekst. Mnoge poruke su odvojene kolonom.
  • Sam tekst SMS može sadržavati kolone i vertikalne trake. za pouzdanu parsing, koristite getSmsFull.
GETgetServicesUsluge

Dostupni servisni kodi.Odgovor je ograničen na područje API ključa.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.
countryintegerUzmi ID od getCountries.

* Potrebni parametri. u svim zahtjevima također prođe akcija=getServices.

Primjer zahtjeva

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

Odgovori

Usluge
{
  "go": {
    "name": "Google",
    "code": "go"
  }
}
  • Direktorat usluga dijeli se po svim dobavljačima. broj dostupnosti provjerava se odvojeno.
GETgetCountriesDržave

ID-ovi, imena i poziva kodovi za zemlje u odabranom kanalu.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.

* Potrebni parametri. u svim zahtjevima također prođe akcija=getCountries.

Primjer zahtjeva

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

Odgovori

Države
{
  "86": {
    "id": 86,
    "name": "Italy",
    "phone_code": "39"
  }
}
GETgetOperatorsOperatori

Dostupni operateri: API ID, naziv i razdoblje zadržavanja naknade.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.
countryintegerUzmi ID od getCountries.
operatorstringUzmi ID od operators/getOperators (API). operator=1 · any/0

* Potrebni parametri. u svim zahtjevima također prođe akcija=getOperators.

Primjer zahtjeva

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

Odgovori

Operatori
{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}
  • Uzmi ID od operators/getOperators (API).
GETgetRewardsNagrada za SMS

Cijene ovise o zemlji. sve su tablice iznose po plaćeni SMS.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.
countryintegerUzmi ID od getCountries.
servicestringDostupni servisni kodi.Odgovor je ograničen na područje API ključa.
operatorstringUzmi ID od operators/getOperators (API). operator=1 · any/0

* Potrebni parametri. u svim zahtjevima također prođe akcija=getRewards.

Primjer zahtjeva

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

Odgovori

JSON
{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}
{}
{}
  • USD tarifni iznosi vraćaju se kao točni desimalni vijek s 8 desimalnih mjesta:
  • Omogućeni pružatelji dostupni su na vašem ključu.
  • country ID → service code → operator ID → reward (USD)
GETgetBalanceStanje korisnika

Dodatno SMScash: dostupna bilanca uzimajući u obzir akruale, referralne bonuse i zahtjeve za plaćanje.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.

* Potrebni parametri. u svim zahtjevima također prođe akcija=getBalance.

Primjer zahtjeva

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

Odgovori

Stanje
ACCESS_BALANCE:0.00
  • getBalance vraća dostupnu USD ravnoteženje na 8 decimalno mjesto.
  • Mogu se isplatiti samo sredstva kojima je završilo razdoblje zadržavanja.
GETgetHoldBalanceZadržano

Nakon primitka SMS poruke, zarada se zadržava tijekom razdoblja koje odredi dobavljač. Na navedeni datum iznos automatski postaje dostupan za isplatu.

Parametri

ParametriTipoviOpis
api_key*stringOsobni API ključ korisnika.

* Potrebni parametri. u svim zahtjevima također prođe akcija=getHoldBalance.

Primjer zahtjeva

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

Odgovori

Zadržano
ACCESS_HOLD_BALANCE:34.50000001
  • SMScash · getHoldBalance · USD · 8
  • Mogu se isplatiti samo sredstva kojima je završilo razdoblje zadržavanja.

Kodovi odgovora i ponavljanje zahtjeva

U handler_api.php poslovni rezultati obično dolazi s HTTP 200. Provjeri tekst tijela. direktorije i getSmsFull Vraćanje JSON ako je uspešno; greške su uvijek tekst.

KodoviHTTPUzrok i sljedeći korak
TARIFF_NOT_CONFIGURED200Stopa još nije postavljenaBroj dodjele počinje nakon što se konfigure SMS nagrade.
COUNTRY_BLOCKED200Broj dodjele za ovu zemlju je blokiran.Izaberite drugu zemlju.
BAD_SERVICE200Broj dodjele za ovu uslugu je blokiran.Izaberite još jednu uslugu.
PROVIDER_NOT_READY200Broj dodjele privremeno nije dostupanOživljajte API kataloge.
BAD_KEY400Ne api_key ili nevažeći format.Provjerite ključ u zahtjevu.
INVALID_API_KEY401Ključ je nepoznat, otkazan ili račun je isključen.Stvorite valjan API ključ.
BAD_COUNTRY400Država je nedostajala ili ne pozitivna brojka.Uzmi ID od getCountries.
BAD_SESSION_DURATION400Telefonski brojevi se izdaju za točno 20 minuta.Ispravno session_duration.
BAD_REQUEST400Nevažeći parametr ili Idempotency-Key.Molimo ispravite zahtjev.
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER200Nepoznati ili isključeni članak direktora.Oživljajte API kataloge.
BAD_NUMBER200Neispravan brojni format.Upišite broj u brojke.
BAD_ACTION / BAD_STATUS200Nepoznata zapovijed, ID ili operacija.Provjerite postavke
EMPTY_POOL200Trenutno nema odgovarajućih telefonskih brojeva.Ponovite nakon 10-30 sekundi ili promijeniti filtre.
NUMBER_IN_USE200Poseban broj je zauzet aktivnom sjednicom.Završite sjednicu ili odaberite još jedan broj.
NO_ACTIVATION200Sjednica ili prethodni broj ne pripada vašem računu.Provjerite ID i ključ.
SESSION_CLOSED / SMS_REQUIRED200Trenutno je državna tranzicija nedostupna.Provjerite stanje i dostupnost SMS poruka.
SCOPE_BLOCKED200Služba, zemlja ili dobavljač nije ovlašten za ključ.Obavijest o opsegu API ključa.
IDEMPOTENCY_CONFLICT200Ovaj ključ za upit je već povezan s drugim parametrima.Za novu operaciju, stvorite još jedan Idempotency-Key.
BAD_REF / SELF_REF400Koda softvera je nepoznata, isključena ili pripada samom korisniku.Upišite kod vlasnika softvera.
INTERNAL_ERROR500Vrijeme je da se provede pogreška servera ili prodavca.Ponavljaj sa zakazom i isto Idempotency-Key.
ALLOCATION_PENDING200Broj dodjele je već u napretku. povlačenje s istim Idempotency-Key.Broj dodjele je već u napretku. povlačenje s istim Idempotency-Key.
ALLOCATION_UNCERTAIN200Rezultati dodjele nisu potvrđeni. automatski povlačenje je onemogućeno kako bi se izbjeglo dodjelu drugog broja.Rezultati dodjele nisu potvrđeni. automatski povlačenje je onemogućeno kako bi se izbjeglo dodjelu drugog broja.

REST vraća predmet {"error":{"code":"…","message":"…"}} i redoviti HTTP statusi 400/401/403/404/409/503.

JSON
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Provjerite polja za zahtjev.",
    "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.

Ostalo za nove integracije

USD tarifni iznosi vraćaju se kao točni desimalni vijek s 8 desimalnih mjesta: 0.00300000 USD.

Valuta bilance je USD. rasporedi zahtjeva i odgovora dostupni su u OpenAPI.

Izlazak u USDT · TRC20Isplate traju od 1 do 45 dana. Naknada za isplatu iznosi 4 $. Oduzima se od traženog iznosa. Nakon primitka SMS poruke, zarada se zadržava tijekom razdoblja koje odredi dobavljač. Na navedeni datum iznos automatski postaje dostupan za isplatu. Mogu se isplatiti samo sredstva kojima je završilo razdoblje zadržavanja.
GET/api/v1/catalogUsluge i zemlje
GET/api/v1/tariffsSMS nagrada po zemlji
GET/api/v1/offersCijene i nagrade
GET/api/v1/servicesDirektorat
GET/api/v1/countriesDirektorat
GET/api/v1/operatorsDirektorat
GET/api/v1/availability?country=1Broj dostupnosti
POST/api/v1/activationsNova sjednica
GET/api/v1/activations/batch?ids=42,43Provjeri više brojeva
GET/api/v1/activationsPosljednjih 200 sjednica: scope=history, čekanje ili sve
GET/api/v1/activations/{id}Sjednica i poruke
GET/api/v1/activations/{id}/sms?after_id=0&limit=100Novi SMS s kurzorom
POST/api/v1/activations/{id}/retryČekajući SMS
POST/api/v1/activations/{id}/finishZavršetak
POST/api/v1/activations/{id}/cancelotkazivanje
POST/api/v1/activations/repeatBroj povratka
GET/api/v1/keysAPI Ključ
POST/api/v1/keysStvorite ključ
PATCH/api/v1/keys/{id}Promjena imena ili politike
DELETE/api/v1/keys/{id}Odbijanje ključa
GET/api/v1/referralsReferentni kod i zarada
GET/api/v1/summaryBalansa i sažetak
GET/api/v1/balanceZadržano
GET/api/v1/ledgerDobitnik Ledger
GET/api/v1/withdrawalsZahtjevi za plaćanje
POST/api/v1/withdrawalsStvorite zahtjev
GET/api/v1/statisticsOpća statistika
GET/api/v1/earnings/holdsZadržavanje zarade

Prihvaćanje samo novih SMS poruka

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": "Koda: 001234",
      "sender": "Service",
      "received_at": "2026-10-09T12:00:00Z"
    }
  ],
  "next_cursor": 101,
  "has_more": false
}

Snimi next_cursor i prodaje ga kao after_id. Ako has_more=true, sljedeća stranica može se odmah pročitati. 1–200. Sesije i SMS Dostupna je samo vlasnika.