Grand SMS
API dokumentation

API dokumentation

Start med en anmodning

14 · API KommandoerREST + handler_api.phpJSON / plain text · Bearer

Skab en API-nøgle i din dashboard, få et nummer og tjek for meddelelser hvert 10 sekunder.Payment er krediteret, når en SMS med en kode ankommer; at læse det igen påvirker ikke din balance.

REST APIhttps://smscash.org/api/v1
Kompatibilitet API base URLhttps://smscash.org/stubs/handler_api.php
Tjenesten er levendeTelefonnummeret er, SMS Der er indtægter til rådighed, og der er tilbagetrukninger til rådighet USDT på TRC20Betalingerne tager mellem 1 og 45 Dagene er.
Eksempelforespørgsel · 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'

Alternativ kompatibel grænsefladeadresse: /handler_api.php. eksisterende REST integrationer fortsætter med at fungere.

API

Opret forespørgsler

cURL · Go · JS · Python
Kompatibilitet API base URLhttps://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'

Nøglen gemmes ikke. Denne kontrol tildeler ikke numre.

Tilbud til nye integrationer

Tjenester og lande

Vælg en service og land. Betaling via SMS afhænger af landet.

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)

Få et nummer
handler_api.php
GET /stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86

Automatisk valg: en tilfældig tilgængelig operatør.

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

Det nummer er gyldigt for 20 Minutter af. SMS Alle kontrolleres 10 Du kan gentagne det, og du kan gentagne det umiddelbart.

Kontrollér flere numre
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
Saldo · Tilbageholdt
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 — Tilgængeligt; held_balance — Tilbageholdt. USD · 8

Kun penge, hvis tilbageholdelsesperiode er udløbet, kan hæves.

Brugsklare klienter

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 · Kompatibilitet API base URLhttps://smscash.org/sms-activate/stubs/handler_api.php
HeroSMS · Kompatibilitet API base URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Brugerens personlige API-nøgle.

Vælg en service og land. Betaling via SMS afhænger af landet.

KodeBeskrivelse
getNumber / getNumberV2Få et nummer
getStatus / getStatusV2Få den nyeste kode
setStatus / finishActivation / cancelActivationStyring af sessioner
getPrices / getNumbersStatusTjek tilgængelighed
getRewards (SMScash)Belønning for SMS
getServicesList / getServicesTjenester
getCountries / getOperatorsTjenester og lande
getActiveActivationsSæsoner
getBalanceBrugerens saldo
getHoldBalance (SMScash)Tilbageholdt

cost = 0 USD · activationCost = 0 USD
reward — Belønning for 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'
Svar
{
  "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.

Det nummer er gyldigt for 20 Minutter af. SMS Alle kontrolleres 10 Du kan gentagne det, og du kan gentagne det umiddelbart.

Autentisering og returer

REST: Hæder Authorization: Bearer YOUR_API_KEY. Kompatibel grænseflade: Parameter api_key og actionBrug af HTTPS.

For at administrere API-nøgler, skal du indtaste din konto.

∞Forespørgsler/min per konto
∞Samtidig sessioner

API-forespørgsel frekvens og antallet af telefonnummer er ubegrænset. Der er ingen daglige eller timeløse kvoter.

Det nummer er gyldigt for 20 Minutter af. SMS Alle kontrolleres 10 Du kan gentagne det, og du kan gentagne det umiddelbart.

API nøgleområde

Du kan begrænse en nøgle til specifikke tjenester, lande og leverandører. tomme lister giver alle de tilgængelige muligheder.

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

PATCH /api/v1/keys/{id} Navnet og politikken ændres helt. hemmeligheden vises kun, når den er skabt.

10% i alt. 5% + 5% med software kode.

Når du udsteder et nummer, bedes du give ref ejet af softwaren. anmodningen er autoriseret af udføreren nøgle. koden er i afsnittet "Referrals" og i GET /api/v1/referrals → software_ref.

AnmodningInvitererSoftware
Uden ref10%—
Med ref5%5%
Med ref, ingen referrer—5%

Plattformen betaler bonusen uden at reducere arbejdstagerens indtjeninger. softwares ejer og referrer kan være den samme person. En arbejdstager kan ikke bruge sin egen kode.

Termerne er fastsatte, når en session er skabt; læsning SMS og tilbagetrækning ændrer dem ikke. Pass ref igen for en ny gentagelse session. I tariff beregningen, en arbejdstager belønning på USD 0.003 giver USD 0.00015 hver til software ejeren og referrer. Den samlede bonus er USD 0.00030.

API Kommandoer

11 XVBC-stil metoder plus din SMScash balance.

GETgetNumberFå et nummer

Oprettes en session og reserveres et tilgængeligt nummer for arbejdstageren. belønningsraten og referral modtagere er fastgjort ved tildeling; belønningen krediteres, når en SMS med en kode ankommer.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
service*stringTilgængelige servicekoder. svaret er begrænset til området for API-nøglen.
country*integerTag ID fra getCountries.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · any/0
session_durationintegerSessionen varer 20 minutter. pass 20 eller undgå denne parameter.
with_operatorinteger1 tilføjer operatørens ID til svaret; 0 eller udeladelse giver tre dele.
refstringПубличный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.

* Anmodet parameter. i alle anmodninger passerer også handling=getNumber.

Eksempelforespørgsel

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

Svar

Udstedt nummer
ACCESS_NUMBER:42:380670000000:1
Ingen tal til rådighed
EMPTY_POOL
  • Automatisk valg: en tilfældig tilgængelig operatør.
  • Et numerisk land uden en pool giver EMPTY_POOL; det forkerte landformat er BAD_COUNTRY.
  • Nøglen til en slettet session fortsætter med at blive brugt: genoptagelse af tildeling med den nøgle returnerer SESSION_CLOSED og udsteder ikke et andet nummer.
  • Det automatiske tilbagetrækning er inaktivt for at undgå at tildele et andet nummer.
GETgetNumbersStatusTjek tilgængelighed

Tilgængelige telefonnummer pr. service og land.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
country*integerTag ID fra getCountries.

* Anmodet parameter. i alle anmodninger passerer også handling=getNumbersStatus.

Eksempelforespørgsel

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

Svar

Tilgængelige tal
{
  "go_0": 0
}
  • _0 suffix betyder et valg uden en bestemt operatør.
  • Tilgængelighed refererer til leverandørens samlede pool. Den valgte kanal kontrolleres, når et nummer er tildelt.
GETgetStatusFå den nyeste kode

Enkel anmodning om sessionstatus og den sidste SMS-kode. ledende zeros i koden er bevaret.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
id*integerDin session ID, der er modtaget, når numret er udstedt.

* Anmodet parameter. i alle anmodninger passerer også handling=getStatus.

Eksempelforespørgsel

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

Svar

Venter
STATUS_WAIT_CODE
Kode modtaget
STATUS_OK:001234
Annullering eller udløb
STATUS_CANCEL
Ikke fundet
NO_ACTIVATION
  • Poll hver 20 sekunder. at læse en besked igen skaber ikke en anden betaling.
  • Efter tilbagetrækning returneres den gamle kode ikke: getStatus venter på den næste SMS.
  • Efter et antal uden SMS er slettet, getStatus og getSms Tilbage STATUS_CANCEL; getSmsFull returnerer den lukkede status, en tom telefon og en tom sms Liste af . REST /activations/{id} og /sms Tilbage 404 NO_ACTIVATION.
GETsetStatusStyring af sessioner

Endes, annulleres eller genoptages i vente på SMS. Sessionen udløber.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
id*integerDin session ID, der er modtaget, når numret er udstedt.
status*integer3 – vent på den næste kode uden at forlænge sessionen; 6 – afsluttes efter SMS; 8 – annulleres umiddelbart.

* Anmodet parameter. i alle anmodninger passerer også handling=setStatus.

Eksempelforespørgsel

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

Svar

Venter på SMS
ACCESS_RETRY_GET
Komplet
ACCESS_ACTIVATION
Aflyst
ACCESS_CANCEL
  • Retry venter på den næste kode inden for de oprindelige 20 minutter. udløbet og udløbetider ændres ikke.
  • Annulleringen fjerner ikke de allerede opnåede belønninger.
  • Kun nummer med en SMS-kode opbevares i historien. Annullerede og udløbet tal uden kode slettes.
GETgetRepeatNumberGør det samme nummer igen

Åbner en ny session med et bestemt nummer fra din historie. Du kan vælge en anden tilgængelig service i det samme land.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
number*stringDer er kun tal og en valgfri ledende + tilladt.
service*stringTilgængelige servicekoder. svaret er begrænset til området for API-nøglen.
session_durationintegerSessionen varer 20 minutter. pass 20 eller undgå denne parameter.
with_operatorinteger1 tilføjer operatørens ID til svaret; 0 eller udeladelse giver tre dele.
refstringПубличный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · any/0

* Anmodet parameter. i alle anmodninger passerer også handling=getRepeatNumber.

Eksempelforespørgsel

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

Svar

Ny session
ACCESS_NUMBER:43:380670000000
Det er stadig nummeret travlt
NUMBER_IN_USE
  • Først, afslutte eller annullere din nuværende session. Hvis numret er travlt, genudskrivning udføres ikke.
  • Den nye session modtager en ny ID og den nuværende pris. gamle SMS kopieres ikke ind i den. ref er indstillet igen.
  • SMScash giver dig mulighed for at gentage kun tal fra denne kontohistorie.
  • Nøglen til en slettet session fortsætter med at blive brugt: genoptagelse af tildeling med den nøgle returnerer SESSION_CLOSED og udsteder ikke et andet nummer.
GETgetSmsFullFå SMS som JSON

Struktureret historie af alle meddelelser med ID, sender, kode, tekst og land, service og leverandør data.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
id*integerDin session ID, der er modtaget, når numret er udstedt.

* Anmodet parameter. i alle anmodninger passerer også handling=getSmsFull.

Eksempelforespørgsel

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

Svar

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"
}
  • Husk sms[].id for at behandle kun nye meddelelser.
  • Numerisk status SMScash: 1 - aktiv, 6 - afsluttet, 8 - annulleret eller udløbet. status_name skiller mellem ventet, modtaget, afsluttet, annulleret, udløbet.
  • Modtagne koder forbliver tilgængelige efter en session afsluttet. For store mængder, brug REST /activations/{id}/sms med after_id.
  • Efter et antal uden SMS er slettet, getStatus og getSms Tilbage STATUS_CANCEL; getSmsFull returnerer den lukkede status, en tom telefon og en tom sms Liste af . REST /activations/{id} og /sms Tilbage 404 NO_ACTIVATION.
GETgetSmsFå SMS som tekststring

Returnerer hele SMS-historien i stringformat til eksisterende kunder.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
id*integerDin session ID, der er modtaget, når numret er udstedt.

* Anmodet parameter. i alle anmodninger passerer også handling=getSms.

Eksempelforespørgsel

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

Svar

Besked
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234
Venter
STATUS_WAIT_CODE
Annullering eller udløb
STATUS_CANCEL
  • Meddelelsesformat: time-kode, meddelelsestext. Flere meddelelser er adskilt af en kolonne.
  • Tekst SMS kan indeholde kolonner og vertikale barer. For pålidelig parsing, brug getSmsFull.
GETgetServicesTjenester

Tilgængelige servicekoder. svaret er begrænset til området for API-nøglen.

Direktoren

Udgivelse…

JSON ↗

Servicedirektorien deles over hele leverandøren.Numret tilgængelighed kontrolleres separat.

Du kan begrænse en nøgle til specifikke tjenester, lande og leverandører. tomme lister giver alle de tilgængelige muligheder.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
countryintegerTag ID fra getCountries.

* Anmodet parameter. i alle anmodninger passerer også handling=getServices.

Eksempelforespørgsel

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

Svar

Tjenester
{
  "go": {
    "name": "Google",
    "code": "go"
  }
}
  • Servicedirektorien deles over hele leverandøren.Numret tilgængelighed kontrolleres separat.
GETgetCountriesLande

ID'er, navne og opkaldskoder for lande i den valgte kanal.

Direktoren

Udgivelse…

JSON ↗

Du kan begrænse en nøgle til specifikke tjenester, lande og leverandører. tomme lister giver alle de tilgængelige muligheder.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.

* Anmodet parameter. i alle anmodninger passerer også handling=getCountries.

Eksempelforespørgsel

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

Svar

Lande
{
  "86": {
    "id": 86,
    "name": "Italy",
    "phone_code": "39"
  }
}
GETgetOperatorsOperatørerne

Tilgængelige operatører: API-ID, navn og tilbageholdelsesperiode.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
countryintegerTag ID fra getCountries.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · any/0

* Anmodet parameter. i alle anmodninger passerer også handling=getOperators.

Eksempelforespørgsel

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

Svar

Operatørerne
{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "operator=1",
    "earnings_hold_days": 45
  }
}
  • Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3.
GETgetRewardsBelønning for SMS

Priser afhænger af landet. Alle tabelmængder er pr. betalte SMS.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
countryintegerTag ID fra getCountries.
servicestringTilgængelige servicekoder. svaret er begrænset til området for API-nøglen.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · any/0

* Anmodet parameter. i alle anmodninger passerer også handling=getRewards.

Eksempelforespørgsel

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

Svar

JSON
{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}
{}
{}
  • USD-tariffemængder returneres som præcise tiende strimler med 8 tiende pladser:
  • Tilgængelige leverandører til din nøgle.
  • country ID → service code → operator ID → reward (USD)
GETgetTopCountriesByServiceТоп стран по сервису

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

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.
service*stringКод сервиса из getServices.

* Anmodet parameter. i alle anmodninger passerer også handling=getTopCountriesByService.

Eksempelforespørgsel

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

Svar

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

Ключ в примереBeskrivelseDirektoren
["12"], ["36"]Land ID
Первый, внешний уровень 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 не задаёт места в рейтинге.
GETgetBalanceBrugerens saldo

Additional SMScash: Tilgængelig balance, der tager hensyn til akrualer, referral bonusser og betalingssøgninger.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.

* Anmodet parameter. i alle anmodninger passerer også handling=getBalance.

Eksempelforespørgsel

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

Svar

Saldo
ACCESS_BALANCE:0.00
  • getBalance returnerer den tilgængelige USD-balance med op til 8 decimalpladser.
  • Kun penge, hvis tilbageholdelsesperiode er udløbet, kan hæves.
GETgetHoldBalanceTilbageholdt

Efter modtagelse af en SMS tilbageholdes indtjeningen i den periode, leverandøren har fastsat. På den angivne dato bliver beløbet automatisk tilgængeligt for hævning.

Parameter

ParameterTyp afBeskrivelse
api_key*stringBrugerens personlige API-nøgle.

* Anmodet parameter. i alle anmodninger passerer også handling=getHoldBalance.

Eksempelforespørgsel

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

Svar

Tilbageholdt
ACCESS_HOLD_BALANCE:34.50000001
  • SMScash · getHoldBalance · USD · 8
  • Kun penge, hvis tilbageholdelsesperiode er udløbet, kan hæves.

Svarkoder og gentagne anmodninger

Ind handler_api.php virksomhedsresultater kommer normalt med HTTP 200. Kontroller kroppens tekst. kataloger og getSmsFull tilbage JSON hvis der er vellykket; fejl er altid tekst.

KodeHTTPÅrsagen og næste skridt
TARIFF_NOT_CONFIGURED200Renterne er endnu ikke fastlagtUddeling af nummer vil begynde, når SMS-præmier er konfigureret.
COUNTRY_BLOCKED200Det er blokeret at tildele nummer til dette land.Vælg et andet land.
BAD_SERVICE200Uddeling af nummer til denne tjeneste er blokeret.Vælg en anden service.
PROVIDER_NOT_READY200Uddeling af nummer er midlertidigt utilgængeligUddyb API katalogerne.
BAD_KEY400Nej api_key eller ugyldig format.Tjek nøglen i anmodningen.
INVALID_API_KEY401Nøglen er ukendt, tilbagekaldt eller kontoen er slået af.Skab en gyldig API-nøgle.
BAD_COUNTRY400Det er et positivt antal, der mangler eller ikke.Tag ID fra getCountries.
BAD_SESSION_DURATION400Telefonnummerene udstedes i 20 minutter.Korrekt session_duration.
BAD_REQUEST400Tjek de anmodningssider.Vælg venligst din anmodning.
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER200ukendt eller disabled katalog element.Uddyb API katalogerne.
BAD_NUMBER200Forkert antal format.Giv det nummer i digter.
BAD_ACTION / BAD_STATUS200ukendt kommando, ID eller operation.Tjek indstillingerne.
EMPTY_POOL200Der er i øjeblikket ingen matchende telefonnummer til rådighed.Gentag efter 10-30 sekunder eller ændre filtre.
NUMBER_IN_USE200Et bestemt antal er besat af en aktiv session.Afslut din session eller vælg et andet nummer.
NO_ACTIVATION200Sessionen eller det tidligere nummer tilhører ikke din konto.Tjek ID og nøgle.
SESSION_CLOSED / SMS_REQUIRED200Den offentlige overgang er for øjeblikket ikke tilgængelig.Se tilstanden og tilgængeligheden af SMS.
SCOPE_BLOCKED200Tjenesten, landet eller leverandøren er ikke tilladt for nøglen.Opdaterer API-nøglen omfang.
INTERNAL_ERROR500Tids- eller serverfejl.Kontakt og support · X-Request-ID
ALLOCATION_PENDING200VentergetActiveActivations · getStatus
ALLOCATION_UNCERTAIN200Det automatiske tilbagetrækning er inaktivt for at undgå at tildele et andet nummer.Det automatiske tilbagetrækning er inaktivt for at undgå at tildele et andet nummer.

Resten returnerer et objekt {"error":{"code":"…","message":"…"}} HTTP-status er 400/401/403/404/409/503.

JSON
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Tjek de anmodningssider.",
    "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.

Tilbud til nye integrationer

USD-tariffemængder returneres som præcise tiende strimler med 8 tiende pladser: 0.00300000 USD.

Valutaen er USD. Forespørgsels- og svarskemaer er tilgængelige i OpenAPI.

Afdrag i USDT · TRC20Udbetalinger tager mellem 1 og 45 dage. Gebyret for hævning er 4 $. Det trækkes fra det ønskede beløb. Efter modtagelse af en SMS tilbageholdes indtjeningen i den periode, leverandøren har fastsat. På den angivne dato bliver beløbet automatisk tilgængeligt for hævning. Kun penge, hvis tilbageholdelsesperiode er udløbet, kan hæves.
GET/api/v1/catalogTjenester og lande
GET/api/v1/tariffsSMS belønning pr. land
GET/api/v1/offersPris og belønning
GET/api/v1/servicesDirektoren
GET/api/v1/countriesDirektoren
GET/api/v1/operatorsDirektoren
GET/api/v1/availability?country=1Tilgængelighed nummer
POST/api/v1/activationsNy session
GET/api/v1/activations/batch?ids=42,43Kontrollér flere numre
GET/api/v1/activationsSidste 200 sessioner: scope=historie, ventet eller alt
GET/api/v1/activations/{id}Session og meddelelser
GET/api/v1/activations/{id}/sms?after_id=0&limit=100Ny SMS med kursor
POST/api/v1/activations/{id}/retryVenter på SMS
POST/api/v1/activations/{id}/finishKomplet
POST/api/v1/activations/{id}/cancelAfbestillinger
POST/api/v1/activations/repeatAntal afrejse
GET/api/v1/keysAPI Nøgler
POST/api/v1/keysSkab en nøgle
PATCH/api/v1/keys/{id}Ændre navn eller politik
DELETE/api/v1/keys/{id}Tilbakeklærte nøgler
GET/api/v1/referralsReferencekode og indtjening
GET/api/v1/summaryBalance og sammendrag
GET/api/v1/balanceTilbageholdt
GET/api/v1/ledgerIndtjening ledger
GET/api/v1/withdrawalsBetalingsforespørgsler
POST/api/v1/withdrawalsSkab en anmodning
GET/api/v1/statisticsGenerelle statistikker
GET/api/v1/earnings/holdsTilbageholdelse af indtjening

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

Lagre next_cursor og send den på, som after_id. Hvis has_more=true, den næste side kan læses straks. begrænsning: 1–200. Sessioner og SMS Der er kun tilgængelige for ejerne.