I-API ukhagamshelana

GET

Kuhlanganisa nge-Satu

14 · API I-CommandREST + handler_api.phpJSON / plain text · Bearer

Ukubonisa isikhumba ye-API kwi-dashboard yakho, ukuthatha isikhumba futhi ukuthatha isikhumba ezingu-10 seku. Ukubalelo kucebisa lapho isikhumba ye-SMS nge-cod; ukuthatha isikhumba ezingu-akhawunti yakho.

REST APIhttps://smscash.org/api/v1

Ukubonisa API I-BASE URLhttps://smscash.org/stubs/handler_api.php

Inkonzo iphilaAmanombolo omcingo, SMS Kutholakala imithombo yokucindezela USDT nge TRC20. Ukuhleleka kuthatha phakathi 1 na 45 izinsuku.

I-Example Izicelo · 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'

Ikheli elinye elivumelanayo: /handler_api.php. Kuqhubeka ukuhlanganisa kweREST okukhona.

API

Umakhi wezicelo

cURL · Go · JS · Python

Ukubonisa API I-BASE URLhttps://smscash.org/stubs/handler_api.php

Ukusebenza actionUsayizi serviceisikhumba countryUkubonisa operatorI-IDs ye-Providers, i-comma ye-izindiza: operator=1,3. Ukukhetha okuzenzakalelayo: umhlinzeki otholakalayo okhethwe ngokungahleliwe.session_durationUsayizi kuyinto 20 izinsuku. Thola 20 noma ukuningi isikhumba.with_operator1 yengeza i-ID yomsebenzisi kunempendulo; 0 noma ukungayifaki kubuyisa izingxenye ezintathu.I-software owner Code ref ref

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'

package main

import (
  "fmt"
  "io"
  "net/http"
  "net/url"
  "os"
  "time"
)

func main() {
  endpoint, err := url.Parse("https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1")
  if err != nil { panic(err) }
  query := endpoint.Query()
  query.Set("api_key", os.Getenv("SMSCASH_API_KEY"))
  endpoint.RawQuery = query.Encode()
  req, err := http.NewRequest("GET", endpoint.String(), nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second, CheckRedirect: func(_ *http.Request, _ []*http.Request) error { return http.ErrUseLastResponse }}
  res, err := client.Do(req)
  if err != nil { panic(err) }
  defer res.Body.Close()
  body, err := io.ReadAll(res.Body)
  if err != nil { panic(err) }
  fmt.Println(res.StatusCode, string(body))
}

JavaScript

// Node.js 18+: set SMSCASH_API_KEY in your environment.
const url = new URL("https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1");
url.searchParams.set("api_key", process.env.SMSCASH_API_KEY);
const response = await fetch(url, {
  method: 'GET',
  signal: AbortSignal.timeout(15000),
  redirect: 'error',
});
const result = await response.text();
console.log(response.status, result);
// SMS codes are strings: keep leading zeros. Never repeat issuance automatically.

Python

import json
import os
import urllib.error
import urllib.parse
import urllib.request

class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

url = "https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1"
parts = urllib.parse.urlsplit(url)
params = dict(urllib.parse.parse_qsl(parts.query))
params["api_key"] = os.environ["SMSCASH_API_KEY"]
url = urllib.parse.urlunsplit(parts._replace(query=urllib.parse.urlencode(params)))
request = urllib.request.Request(url, method='GET')
try:
    with urllib.request.build_opener(NoRedirect).open(request, timeout=15) as response:
        result = response.read().decode("utf-8")
        print(response.status, result)
except urllib.error.HTTPError as error:
    print(error.code, error.read().decode('utf-8'))
    raise
# No automatic retries; SMS codes remain strings.

API ikhaya

Ukhiye awugcinwa. Lokhu kuhlola akuniki izinombolo.

I-REST for Imikhiqizo Zonke

Izinsizakalo namazwe

Ukulinganiswa kwe-service kanye ne-land. I-SMS yokuthengisa kulinganiswa kwe-land.

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)

Ukubonisa imiphumela

handler_api.php

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

Ukukhetha okuzenzakalelayo: umhlinzeki otholakalayo okhethwe ngokungahleliwe.

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

I-NUMBER isikhungo 20 Ukubonisa imiphumela SMS Ukubonisa yonke 10 isonto. Ungayithanda ngokuvamile.

Hlola izinombolo eziningi

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

Ibhalansi · Imali ebanjiwe

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 — Iyatholakala; held_balance — Imali ebanjiwe. USD · 8

Ungakhipha kuphela imali ephelelwe isikhathi sokubanjwa.

Izinhlelo zeklayenti ezilungele ukusetshenziswa

JavaScript / Node.js ↓Python ↓

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 · Ukubonisa API I-BASE URLhttps://smscash.org/sms-activate/stubs/handler_api.php

HeroSMS · Ukubonisa API I-BASE URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Ukhiye we-API womsebenzisi.

Ukulinganiswa kwe-service kanye ne-land. I-SMS yokuthengisa kulinganiswa kwe-land.

I-Code	Ukubonisa
`getNumber / getNumberV2`	Ukubonisa imiphumela
`getStatus / getStatusV2`	Ukulinganiswa kwe-code
`setStatus / finishActivation / cancelActivation`	Ukulinganiso
`getPrices / getNumbersStatus`	Ukubonisa isicelo
`getRewards (SMScash)`	Ukubonisa i-SMS
`getServicesList / getServices`	Izinsizakalo
`getCountries / getOperators`	Izinsizakalo namazwe
`getActiveActivations`	Ukusebenza
`getBalance`	Ibhalansi yomsebenzisi
`getHoldBalance (SMScash)`	Imali ebanjiwe

cost = 0 USD · activationCost = 0 USD
reward — Ukubonisa i-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'

Ukusebenza

{
  "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.

I-NUMBER isikhungo 20 Ukubonisa imiphumela SMS Ukubonisa yonke 10 isonto. Ungayithanda ngokuvamile.

Ukuhlolwa & Ukuhlolwa

REST: I-Header Authorization: Bearer YOUR_API_KEY. I-Interface ye-Compatible I-Parameters api_key Ukubonisa actionUsebenzisa HTTPS.

Ukusebenza API I-key, ingcindezi yakho

∞Izicelo / min ngesi-akhawunti

∞Ukusebenza

I-API isicelo isivinini futhi isithombe ezisombululo ayikeza. Ngaba izindleko ezisombululo noma ezisombululo.

I-NUMBER isikhungo 20 Ukubonisa imiphumela SMS Ukubonisa yonke 10 isonto. Ungayithanda ngokuvamile.

I-API Key Ukusebenza

Ungayithanda isikhumba ku-services, izindawo kanye nemikhiqizo. Izithombe ezingenakashwa ukunikeza zonke izindlela ezingenakashwa.

JSON

{
  "label": "I-Software",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} ishintsha igama nesimiso ngokuphelele. Imfihlo iboniswa kuphela lapho yenziwa.

10% ku-total. 5% + 5% nge-software code.

Uma ukuthatha isikhumba, sicela ukuthatha ref umnini wesoftware. Isicelo sigunyazwa isishuxulelo se-umsebenzisi. Ikhodi lisengxenyeni ye-"Referrals" naseku GET /api/v1/referrals → software_ref.

Ukusebenza	Ukusebenza	I-Software
Ngaphandle ref	10%	—
Ukusebenza kwe-Ref	5%	5%
Ukusebenza kwe-ref, akukho umbhalo	—	5%

I-platform ayikeza i-bonus ngaphandle kokusebenzisa i-abasebenzisi. I-software owner kanye ne-referrer ayikeza. I-abasebenzisi ayikeza kubasebenzisi wakho.

I-Curriculum isikhungo ku-session isikhungo; ukuthatha i-SMS futhi i-retry ayikeza. Ukubonisa i-ref ye-new i-repeat session. Ngokuvamile, i-USD 0.003 isikhungo ye-abasebenzisi ayikeza i-USD 0.00015 isikhungo ye-software futhi i-referrer. I-bonus ye-USD 0.00030.

API I-Command

11 XVBC-style izindlela plus yakho SMScash isibani.

GETgetNumberUkubonisa imiphumela

Ukubonisa isisindo futhi isisindo isisindo ezisindo. I-premier rate kanye ne-referral recipients isikhumba ku-indle; isisindo isikhumba lapho isisindo ye-SMS nge-cod.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`service`*	string	Amakhodi enkonzo atholakala. Impendulo iphela kuphela kwindawo yesishuxulelo se-API.
`country`*	integer	Thatha ID kusuka getCountries.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`
`session_duration`	integer	Usayizi kuyinto 20 izinsuku. Thola 20 noma ukuningi isikhumba.
`with_operator`	integer	1 yengeza i-ID yomsebenzisi kunempendulo; 0 noma ukungayifaki kubuyisa izingxenye ezintathu.
`ref`	string	Публичный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getNumber.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1",
    timeout=15,
)
print(response.status_code, response.text)

Ukusebenza

I-NUMBER I-NUMBER

ACCESS_NUMBER:42:380670000000:1

Usayizi yokusebenza

EMPTY_POOL

Ukukhetha okuzenzakalelayo: umhlinzeki otholakalayo okhethwe ngokungahleliwe.
I-land nomaneli ngaphandle kwe-pool kuyinto EMPTY_POOL; i-land isifakazi kuyinto BAD_COUNTRY.
Isishuxulelo senhlanganiso ecishiwe sisele sisetshenziswa: ukudlala kwakhona ukwakhiwa ngaleso kinombhozo sibuyela SESION_CLOSED futhi asibiki elinye inani.
Umphumela wokwakhiwa awuqinisekiswanga. Ukuzama ngokuzenzakalela kukhubazekile ukuze kugweme ukunikezela inani lesibili.

GETgetNumbersStatusUkubonisa isicelo

I-Nombor ye-Telephone ye-Service kanye ne-Land.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`country`*	integer	Thatha ID kusuka getCountries.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getNumbersStatus.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86",
    timeout=15,
)
print(response.status_code, response.json())

Ukusebenza

I-Nombro

{
  "go_0": 0
}

I- _0 suffix kuyinto isizindiza ngaphandle koku-operator isizindiza.
Ukutholakala kubhekisela engxenyeni ephelele yomnikezeli. Isiqhagamsheli esikhethiwe sihlolwa lapho inani elithile linikelwe.

GETgetStatusUkulinganiswa kwe-code

Ukucaciswa ngokushesha kwe-session status kanye ne-SMS kwangaphakathi. I-zero ezisindo ku-cod isikhumba.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`id`*	integer	ID yakho, ukuthatha lapho isikhwama kuqala.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getStatus.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42",
    timeout=15,
)
print(response.status_code, response.text)

Ukusebenza

Ukubonisa

STATUS_WAIT_CODE

I-code engaphakathi

STATUS_OK:001234

Ukubalwa noma ukubalwa

STATUS_CANCEL

Ngaba

NO_ACTIVATION

I-Poll every 20 seconds. Ukubuyisa isisekelo ngonyaka ka-Nga, ingcindezi ngonyaka ka-Nga.
Ngemva ukwelashwa, i-code yayo ayikuthwa: getStatus isikhumba kwi-SMS yayo.
Ngaphezu kwalokho, ngaphandle SMS isikhumba, getStatus Ukubonisa getSms Ukugcisa STATUS_CANCEL; getSmsFull ukuthatha isikhumba lokushisa, isikhumba lokushisa, isikhumba lokushisa sms isifundo REST /activations/{id} Ukubonisa /sms Ukugcisa 404 NO_ACTIVATION.

GETsetStatusUkulinganiso

Ukuphakama, ukulawula noma ukulawula ukulawula SMSI-Session isikhwama isikhwama.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`id`*	integer	ID yakho, ukuthatha lapho isikhwama kuqala.
`status`*	integer	3 — ukujabulela isikhumba ezizayo ngaphandle kokuzalwa; 6 — ukunyuka emva kwe-SMS; 8 — ukunyuka ngokushesha.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =setStatus.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3",
    timeout=15,
)
print(response.status_code, response.text)

Ukusebenza

Ukubonisa i-SMS

ACCESS_RETRY_GET

Ukusebenza

ACCESS_ACTIVATION

Ukubonisa

ACCESS_CANCEL

Zama ukulinda imithetho elandelayo ngaphakathi kwemizuzu engu - 20 yokuqala.
I-Cancellation ayikeza ukulawula izindiza ezivumelwano.
Amanombolo kuphela anekhodi le-SMS agcinwa emlandweni. Cishiwe futhi apheliwe ngaphandle kwekhodi acishiwe.

GETgetRepeatNumberBuyisela futhi inani elifanayo

Ukubonisa isisindo entsha nge isisindo esisindo yakho. Ungasiza isisindo ezisindo ezisindo ezisindo.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`number`*	string	I-Old Number. Isikhathi kuphela izinga futhi isikhwama + isikhwama.
`service`*	string	Amakhodi enkonzo atholakala. Impendulo iphela kuphela kwindawo yesishuxulelo se-API.
`session_duration`	integer	Usayizi kuyinto 20 izinsuku. Thola 20 noma ukuningi isikhumba.
`with_operator`	integer	1 yengeza i-ID yomsebenzisi kunempendulo; 0 noma ukungayifaki kubuyisa izingxenye ezintathu.
`ref`	string	Публичный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getRepeatNumber.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go",
    timeout=15,
)
print(response.status_code, response.text)

Ukusebenza

ACCESS_NUMBER:43:380670000000

I-Nombro kuyinto engcono

NUMBER_IN_USE

Okokuqala, ukunyuka noma ukunyuka isikhumba yakho esiyilayo. Ukuba isikhumba isithuba, ukunyuka isikhumba isikhumba isikhumba.
I-Session entsha ayikuthunyelwe kw-ID entsha futhi kwama-cash. I-SMS yayo ayikuthunyelwe. ref isikhumba.
SMScash inokuthumela ukuthumela kuphela izinga kusukela kwizikhali le-akhawunti. I-land isifakile nge-nombolo.
Isishuxulelo senhlanganiso ecishiwe sisele sisetshenziswa: ukudlala kwakhona ukwakhiwa ngaleso kinombhozo sibuyela SESION_CLOSED futhi asibiki elinye inani.

GETgetSmsFullUkubonisa SMS njengoba JSON

Umthamo lokushisa zonke iimali nge ID, umthamo, i-code, i-text and country, i-service and supplier data.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`id`*	integer	ID yakho, ukuthatha lapho isikhwama kuqala.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getSmsFull.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42",
    timeout=15,
)
print(response.status_code, response.json())

Ukusebenza

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

I-format ye-integration. Ukubonisa i-SMS[].ID ukuze kufuneka kubasebenza kuphela i-new messages.
Isimo somanani SMScash: 1 - okusebenzayo, 6 - iqediwe, 8 - icishiwe noma iphelile. status_name ukuhlukanisa phakathi kokulinda, kwamukelwa, kuqeda, kucishiwe, kuphelelwe.
I-codes ezivakashi ziye kunikwazi emva kokusebenza. Ukuze imikhiqizo ezizodwa, usebenzisa i-REST /activations/{id}/sms nge-after_id.
Ngaphezu kwalokho, ngaphandle SMS isikhumba, getStatus Ukubonisa getSms Ukugcisa STATUS_CANCEL; getSmsFull ukuthatha isikhumba lokushisa, isikhumba lokushisa, isikhumba lokushisa sms isifundo REST /activations/{id} Ukubonisa /sms Ukugcisa 404 NO_ACTIVATION.

GETgetSmsUkusebenzisa SMS njengesithombe

Ukubonisa yonke imizuzu ye-SMS kwi-string format ye-clients ezininzi.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`id`*	integer	ID yakho, ukuthatha lapho isikhwama kuqala.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getSms.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42",
    timeout=15,
)
print(response.status_code, response.text)

Ukusebenza

STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234

Ukubonisa

STATUS_WAIT_CODE

Ukubalwa noma ukubalwa

STATUS_CANCEL

Ifomethi lomyalezo: timeʹcodeӗtext. Imilayezo emininingana ihlukaniswa yikoloni.
Umbhalo SMS ngokwakhe kungase kuqukethe amakoloni nezigciwane eziqondile. getSmsFull.

GETgetServicesIzinsizakalo

Amakhodi enkonzo atholakala. Impendulo iphela kuphela kwindawo yesishuxulelo se-API.

I-Director

Ukushicilela…

JSON ↗

I-directory ye-service isishayizi phakathi kwe-supplier. I-Number yokusebenza isishayizi ngokushesha.

Ungayithanda isikhumba ku-services, izindawo kanye nemikhiqizo. Izithombe ezingenakashwa ukunikeza zonke izindlela ezingenakashwa.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`country`	integer	Thatha ID kusuka getCountries.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getServices.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY",
    timeout=15,
)
print(response.status_code, response.json())

Ukusebenza

Izinsizakalo

{
  "go": {
    "name": "Google",
    "code": "go"
  }
}

I-directory ye-service isishayizi phakathi kwe-supplier. I-Number yokusebenza isishayizi ngokushesha.

GETgetCountriesAmazwe

I-IDs, i-ime futhi i-coding ye-many ye-channel ye-selected.

I-Director

Ukushicilela…

JSON ↗

Ungayithanda isikhumba ku-services, izindawo kanye nemikhiqizo. Izithombe ezingenakashwa ukunikeza zonke izindlela ezingenakashwa.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getCountries.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY",
    timeout=15,
)
print(response.status_code, response.json())

Ukusebenza

Amazwe

{
  "86": {
    "id": 86,
    "name": "Italy",
    "phone_code": "39"
  }
}

GETgetOperatorsUkubonisa

Abasebenzisi abatholakalayo: i-ID ye-API, igama nesikhathi sokubamba umvuzo.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`country`	integer	Thatha ID kusuka getCountries.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getOperators.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY",
    timeout=15,
)
print(response.status_code, response.json())

Ukusebenza

Ukubonisa

{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "operator=1",
    "earnings_hold_days": 45
  }
}

Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3.

GETgetRewardsUkubonisa i-SMS

I-cash isizindiza ku-many. I-cash isizindiza zonke i-SMS.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`country`	integer	Thatha ID kusuka getCountries.
`service`	string	Amakhodi enkonzo atholakala. Impendulo iphela kuphela kwindawo yesishuxulelo se-API.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getRewards.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi",
    timeout=15,
)
print(response.status_code, response.json())

Ukusebenza

JSON

{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}

{}

{}

I-USD izindleko zokusebenza njengesikhumba decimal ngokuvamile nge-8 izindawo decimal:
I-Providers isicelo ekusebenzayo kwizikhungo yakho.
country ID → service code → operator ID → reward (USD)

GETgetTopCountriesByServiceТоп стран по сервису

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

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.
`service`*	string	Код сервиса из getServices.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getTopCountriesByService.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getTopCountriesByService&api_key=YOUR_API_KEY&service=go", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getTopCountriesByService&api_key=YOUR_API_KEY&service=go");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getTopCountriesByService&api_key=YOUR_API_KEY&service=go",
    timeout=15,
)
print(response.status_code, response.json())

Ukusebenza

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

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

GETgetBalanceIbhalansi yomsebenzisi

Ukusebenza SMScash: isikhwama elihle ngokuvamile, i-referral bonuses kanye nezikwazi yokuthengisa.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getBalance.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY",
    timeout=15,
)
print(response.status_code, response.text)

Ukusebenza

Ibhalansi

ACCESS_BALANCE:0.00

getBalance ukuthumela i-USD ekuqaleni nge-akhawunti ye-8 decimal.
Ungakhipha kuphela imali ephelelwe isikhathi sokubanjwa.

GETgetHoldBalanceImali ebanjiwe

Ngemuva kokuthola i-SMS, imali engenayo ibanjwa isikhathi esibekwe umhlinzeki. Ngosuku olubekiwe, imali itholakala ngokuzenzakalelayo ukuze ikhishwe.

Izingcali

I-Parameter	I-Type	Ukubonisa
`api_key`*	string	Ukhiye we-API womsebenzisi.

* I-parameter isicelo. In zonke izicelo ziye ukuthatha ukwamukela =getHoldBalance.

I-Example Izicelo

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY",
    timeout=15,
)
print(response.status_code, response.text)

Ukusebenza

Imali ebanjiwe

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
Ungakhipha kuphela imali ephelelwe isikhathi sokubanjwa.

I-codes yokusebenza kanye nezidingo yokusebenza

Ngaphakathi handler_api.php imiphumela yebhizinisi ngokuvamile ivela nayo HTTP 200. Hlola umbhalo wemzimba. Izithombe getSmsFull buyela JSON uma kuphumelele; amaphutha ahlale ebhalwe umbhalo.

I-Code	HTTP	Umthamo kanye nokuqala
`TARIFF_NOT_CONFIGURED`	200	I-cards ayikezaI-Number Assignment isizindiza ngokuvamile SMS Izinto zokusebenza.
`COUNTRY_BLOCKED`	200	I-Nombor isikhumba kwama-makhemithi isikhumba.Ukubonisa indawo yokuqala
`BAD_SERVICE`	200	I-Nombor isikhumba ye-Service isikhumba.Ungasebenzisa isicelo ezingu.
`PROVIDER_NOT_READY`	200	Ukunikezwa kwenani akukho kwesikhashanaUkusebenza kwe-API izikhwama.
`BAD_KEY`	400	Cha api_key noma ifomethi engalungile.Ukubonisa isikhumba ku-Sayensi.
`INVALID_API_KEY`	401	I-key is unknown, isikhumba noma isikhumba isikhumba.Ukubonisa isikhumba ye-API esizayo.
`BAD_COUNTRY`	400	izwe lilahlekelwa noma lingekho inani elihle.Thatha ID kusuka getCountries.
`BAD_SESSION_DURATION`	400	I-telephone isikhumba kuzenzakalelayo ku-20 imizuzu.Lungisa session_duration.
`BAD_REQUEST`	400	Ukubonisa izicelo izindawo.Sishayele ukulawula isicelo yakho.
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Izinto yokuhlanza noma isikhumba izinto.Ukusebenza kwe-API izikhwama.
`BAD_NUMBER`	200	I-Format isikhumba isikhumba.Ukubonisa i-Number ku-digits.
`BAD_ACTION / BAD_STATUS`	200	Ukubonisa imiphumela, ID noma operations.Ukubonisa imikhiqizo
`EMPTY_POOL`	200	Ngaphezu kwalokho, isitimela yokushisa isitimela yokushisa.Ukuphindana emva kokusebenza kwe-10-30 sekuints noma ukuphindana kwe-filters.
`NUMBER_IN_USE`	200	Umthamo esisodwa isizindiza ngokuvamile.Ukushisa isikhwama yakho noma ukushisa isikhwama entsha.
`NO_ACTIVATION`	200	I-Session noma i-Number ye-Session ayikeza kwizikhumbi yakho.Ukubonisa ID kanye nokuVela.
`SESSION_CLOSED / SMS_REQUIRED`	200	Ukucaciswa kwe-state isizindiza.Ukubonisa izinga kanye nokufaka kwe-SMS.
`SCOPE_BLOCKED`	200	Usayizi, zemithi, noma isitimela isitimela isitimela.Ukubonisa isithombe ye-API.
`INTERNAL_ERROR`	500	I-server noma i-seller isikhumba.Xhumana nathi nosizo · X-Request-ID
`ALLOCATION_PENDING`	200	UkubonisagetActiveActivations · getStatus
`ALLOCATION_UNCERTAIN`	200	Umphumela wokwakhiwa awuqinisekiswanga. Ukuzama ngokuzenzakalela kukhubazekile ukuze kugweme ukunikezela inani lesibili.Umphumela wokwakhiwa awuqinisekiswanga. Ukuzama ngokuzenzakalela kukhubazekile ukuze kugweme ukunikezela inani lesibili.

I-REST kuyinto ukwakha umkhakha {"error":{"code":"…","message":"…"}} futhi izinga HTTP ezingenakashwa 400/401/403/404/409/503.

JSON

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Ukubonisa izicelo izindawo.",
    "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.

I-REST for Imikhiqizo Zonke

I-USD izindleko zokusebenza njengesikhumba decimal ngokuvamile nge-8 izindawo decimal: 0.00300000 USD.

I-USD. I-Squema ye-Request and Response is available in OpenAPI.

Ukusekelwa ku USDT · TRC20Izinkokhelo zithatha izinsuku ezingu-1 kuya kwezingu-45. Imali ekhokhwayo yokukhipha ngu-4 $. Idonswa enanini eliceliwe. Ngemuva kokuthola i-SMS, imali engenayo ibanjwa isikhathi esibekwe umhlinzeki. Ngosuku olubekiwe, imali itholakala ngokuzenzakalelayo ukuze ikhishwe. Ungakhipha kuphela imali ephelelwe isikhathi sokubanjwa.

GET/api/v1/catalogIzinsizakalo namazwe

GET/api/v1/tariffsInani lemvuzo yeSMS ngezwe

GET/api/v1/offersIzinkampani

GET/api/v1/servicesI-Director

GET/api/v1/countriesI-Director

GET/api/v1/operatorsI-Director

GET/api/v1/availability?country=1Usayizi

POST/api/v1/activationsUkusebenza

GET/api/v1/activations/batch?ids=42,43Hlola izinombolo eziningi

GET/api/v1/activationsI-ulwazi ye-200: isikhungo = isikhungo, isikhungo noma zonke

GET/api/v1/activations/{id}Ukusebenza kanye nesisekelo

GET/api/v1/activations/{id}/sms?after_id=0&limit=100I-SMS nge-cursor

POST/api/v1/activations/{id}/retryUkubonisa i-SMS

POST/api/v1/activations/{id}/finishUkusebenza

POST/api/v1/activations/{id}/cancelUkubonisa

POST/api/v1/activations/repeatI-NUMBER

GET/api/v1/keysAPI ikhaya

POST/api/v1/keysUkusebenza kwe-key

PATCH/api/v1/keys/{id}Izinto noma izinto

DELETE/api/v1/keys/{id}Ukubonisa imikhiqizo

GET/api/v1/referralsI-Code Referral kanye nezinkampani

GET/api/v1/summaryisikhwama kanye isikhwama

GET/api/v1/balanceImali ebanjiwe

GET/api/v1/ledgerIzinkampani

GET/api/v1/withdrawalsIzicelo yokuthengisa

POST/api/v1/withdrawalsUkusebenza kwe-Request

GET/api/v1/statisticsUkusebenza

GET/api/v1/earnings/holdsUkubanjwa kwemali engenayo

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

Ukusebenza next_cursor Ngena ngemvume after_idI-Ibhizinisi has_more=true, isikhwama ezizayo ayikeza ngokushesha. limit: 1–200. izikhumba & SMS isicelo kuphela kwizinto.