API Dokumentų

GET

Pradėkite nuo vieno prašymo

14 · API ĮsakymaiREST + handler_api.phpJSON / plain text · Bearer

Sukurkite API raktą savo lentynos, gaukite skaičių ir peržiūrėkite pranešimus kas 10 sekundžių. mokėjimas yra kredituojamas, kai atvyksta SMS su kodu; vėl skaityti nepažeidžia jūsų balanso.

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

Suderinamumo API bazės URLhttps://smscash.org/stubs/handler_api.php

Paslauga gyvatelefono numerius , SMS ir pajamos yra prieinamos. atšaukimai yra prieinami USDT ant TRC20Mokėjimai tarp 1 ir 45 Dienų .

Pavyzdinis prašymas · 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'

Alternatyvi suderinama sąsajos adresas: /handler_api.php. esamos REST integracijos ir toliau veikia.

API

Užklausų kūrimo įrankis

cURL · Go · JS · Python

Suderinamumo API bazės URLhttps://smscash.org/stubs/handler_api.php

Prašymas actionPaslaugų serviceŠalis countryOperatorius operatorPaslaugų teikėjo ID, komos atskiriamos: operator=1,3. Automatinis pasirinkimas: atsitiktinis prieinamas operatorius.session_durationSėkmė trunka 20 minučių. praleiskite 20 arba pamirškite šį parametrą.with_operator1 prideda operatoriaus ID prie atsakymo; 0 arba praleistas parametras grąžina tris dalis.Programinės įrangos savininkas kodas 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 raktas

Raktas neišsaugomas. Šis patikrinimas nesuteikia numerių.

Naujų integracijų laukia

Paslaugos ir šalys

Pasirinkite paslaugą ir šalį. mokėjimas SMS priklauso nuo šalies.

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)

Gaukite skaičių

handler_api.php

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

Automatinis pasirinkimas: atsitiktinis prieinamas operatorius.

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

Šis skaičius galioja 20 Minutės SMS Kiekvienas tikrinamas 10 Anksčiau galite atšaukti.

Patikrinti kelis numerius

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

Likutis · Sulaikyta

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 — Galima naudoti; held_balance — Sulaikyta. USD · 8

Galima išsiimti tik lėšas, kurių sulaikymo laikotarpis pasibaigė.

Paruošti klientai

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 · Suderinamumo API bazės URLhttps://smscash.org/sms-activate/stubs/handler_api.php

HeroSMS · Suderinamumo API bazės URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Asmeninis naudotojo API raktas.

Pasirinkite paslaugą ir šalį. mokėjimas SMS priklauso nuo šalies.

Kodas	Aprašymas
`getNumber / getNumberV2`	Gaukite skaičių
`getStatus / getStatusV2`	Gaukite naujausią kodą
`setStatus / finishActivation / cancelActivation`	Sėkmės vadybos
`getPrices / getNumbersStatus`	Peržiūrėkite prieinamumą
`getRewards (SMScash)`	Apdovanojimai SMS
`getServicesList / getServices`	Paslaugos
`getCountries / getOperators`	Paslaugos ir šalys
`getActiveActivations`	sesijos
`getBalance`	Naudotojo likutis
`getHoldBalance (SMScash)`	Sulaikyta

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

Atsakymai

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

Šis skaičius galioja 20 Minutės SMS Kiekvienas tikrinamas 10 Anksčiau galite atšaukti.

Autentika ir atleidimas

REST: Širdis Authorization: Bearer YOUR_API_KEY. Suderinamas sąsajas: Parametrai api_key ir actionNaudokite HTTPS

Norėdami valdyti API raktus, įveskite savo sąskaitą.

∞Užsakymai / min. už sąskaitą

∞Simultaniškos sesijos

API prašymo dažnis ir telefono numeriai yra neribotos. nėra kasdieninių ar valandinių kvotų.

Šis skaičius galioja 20 Minutės SMS Kiekvienas tikrinamas 10 Anksčiau galite atšaukti.

Pagrindinis API

Galite apriboti raktą konkrečioms paslaugoms, šalims ir teikėjams. tuštieji sąrašai leidžia visus turimus variantus.

JSON

{
  "label": "Mano programinė įranga",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} Pavadinimas ir politika visiškai keičiasi. paslaptis rodomas tik tada, kai sukurta.

10% bendra. 5% + 5% su programinės įrangos kodu.

Kai išduodate numerį, prašome pateikti ref programinės įrangos savininkas. prašymą patvirtina vykdytojo raktas. kodas yra "Referral" skyriuje ir GET /api/v1/referrals → software_ref.

Prašymas	Kvietimas	Programinė įranga
Be ref	10%	—
Su ref	5%	5%
Su ref, be referer	—	5%

Platforma moka premiją, nesumažinant naudotojo pajamų. programinės įrangos savininkas ir referentas gali būti tas pats asmuo.

Terminai nustatomi, kai yra sukurta sesijos; skaityti SMS ir atleidimas nesikeičia. vėl perkelti ref naujo pasikartojimo sesijos. tarifo apskaičiavime naudotojo atlyginimas USD 0.003 suteikia USD 0.00015 kiekvienam programinės įrangos savininkui ir referer. bendras premijos dydis yra USD 0.00030.

API Įsakymai

11 XVBC stiliaus metodai ir jūsų SMScash balansas.

GETgetNumberGaukite skaičių

Sėkmė sukuriama ir naudotojams išsaugomas numeris. atlyginimo norma ir atsiliepimų gavėjai nustatomi paskirstymo metu; atlyginimas kredituojamas, kai atvyksta SMS su kodu.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`service`*	string	Paslaugų kodai. Atsakymas yra ribotas API raktų srityje.
`country`*	integer	Paimkite ID iš getCountries.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`
`session_duration`	integer	Sėkmė trunka 20 minučių. praleiskite 20 arba pamirškite šį parametrą.
`with_operator`	integer	1 prideda operatoriaus ID prie atsakymo; 0 arba praleistas parametras grąžina tris dalis.
`ref`	string	Публичный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getNumber.

Pavyzdinis prašymas

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)

Atsakymai

Išduotas skaičius

ACCESS_NUMBER:42:380670000000:1

Nėra numerių

EMPTY_POOL

Automatinis pasirinkimas: atsitiktinis prieinamas operatorius.
Numerinė šalis be baseino suteikia EMPTY_POOL; neteisinga šalis yra BAD_COUNTRY.
Ištrintos sesijos raktas išlieka naudojamas: atnaujinant paskirties su tuo raktu grąžinama SESSION_CLOSED ir neatsisako kito numero.
Automatinis atleidimas neįjungtas, kad būtų išvengta antrojo numero paskirstymo.

GETgetNumbersStatusPeržiūrėkite prieinamumą

Telefonų numeriai pagal paslaugą ir šalį.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`country`*	integer	Paimkite ID iš getCountries.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getNumbersStatus.

Pavyzdinis prašymas

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())

Atsakymai

Galimi skaičiai

{
  "go_0": 0
}

_0 suffix reiškia pasirinkimą be konkrečios operatorius.
Galimybė reiškia tiekėjo bendrą baseiną. pasirinktas kanalas tikrinamas, kai numeris yra paskirstytas.

GETgetStatusGaukite naujausią kodą

Lengvas prašymas sesijos būklės ir paskutinio SMS kodo. pirmaujančių nulų kodas išsaugotas.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`id`*	integer	Jūsų sesijos ID, gautas, kai buvo išduotas numeris.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getStatus.

Pavyzdinis prašymas

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)

Atsakymai

Laukiama

STATUS_WAIT_CODE

Kodas gautas

STATUS_OK:001234

Atšaukimas arba pabaiga

STATUS_CANCEL

nerastas

NO_ACTIVATION

Poll kas 20 sekundžių. skaityti pranešimą vėl nesukelia kito mokėjimo.
Po retry senos kodas nėra grąžintas: getStatus laukia kitą SMS.
Po skaičiaus be SMS Jis ištrintas, getStatus ir getSms Grįžimas STATUS_CANCEL; getSmsFull grąžina uždarą statusą, tuščią telefoną ir tuščią sms Įrašas . REST /activations/{id} ir /sms Grįžimas 404 NO_ACTIVATION.

GETsetStatusSėkmės vadybos

Pasibaigia, atšaukia arba atnaujina laukiant SMS. Sesijos pabaiga išlieka ta pati.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`id`*	integer	Jūsų sesijos ID, gautas, kai buvo išduotas numeris.
`status`*	integer	3 – laukti kito kodo be pratęsimo sesijos; 6 – baigti po SMS; 8 – nedelsiant atšaukti.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =setStatus.

Pavyzdinis prašymas

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)

Atsakymai

Laukiame SMS

ACCESS_RETRY_GET

Užbaigtas

ACCESS_ACTIVATION

Atšauktas

ACCESS_CANCEL

Grąžinimas laukia kito kodo per 20 minučių. išleidimo ir pabaigos laikas nesikeičia.
Atšaukimas neatmeta jau uždirbtų atlyginimų.
Istorijoje laikomi tik numeriai su SMS kodu. atšaukti ir pasibaigę numeriai be kodo ištrinami.

GETgetRepeatNumberVėl įdėti tą patį skaičių

Atidarykite naują sesiją su konkrečiu skaičiumi iš savo istorijos. galite pasirinkti kitą prieinamą paslaugą toje pačioje šalyje.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`number`*	string	Tik numerius ir pasirinktas lyderis + leidžiama.
`service`*	string	Paslaugų kodai. Atsakymas yra ribotas API raktų srityje.
`session_duration`	integer	Sėkmė trunka 20 minučių. praleiskite 20 arba pamirškite šį parametrą.
`with_operator`	integer	1 prideda operatoriaus ID prie atsakymo; 0 arba praleistas parametras grąžina tris dalis.
`ref`	string	Публичный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getRepeatNumber.

Pavyzdinis prašymas

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)

Atsakymai

Naujoji sesijos

ACCESS_NUMBER:43:380670000000

Dabar skaičius dar užimtas

NUMBER_IN_USE

Pirma, užbaigti arba atšaukti dabartinę sesiją.Jei skaičius yra užimtas, pakartotinis išleidimas neįvyksta.
Naujoji sesija gauna naują ID ir dabartinę tarifą. senas SMS nėra kopijuotas į ją. ref yra vėl nustatytas.
SMScash leidžia kartoti tik skaičius iš šio sąskaitos istorijos. šalis yra nustatyta pagal skaičių.
Ištrintos sesijos raktas išlieka naudojamas: atnaujinant paskirties su tuo raktu grąžinama SESSION_CLOSED ir neatsisako kito numero.

GETgetSmsFullSMS siunčiama kaip JSON

Struktūrizuota visų pranešimų istorija su ID, siuntėjo, kodo, teksto ir šalies, paslaugų ir tiekėjo duomenimis.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`id`*	integer	Jūsų sesijos ID, gautas, kai buvo išduotas numeris.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getSmsFull.

Pavyzdinis prašymas

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())

Atsakymai

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

Atminkite SMS[].id, kad galėtumėte apdoroti tik naujus pranešimus.
Numerinis statusas SMScash: 1 - aktyvus, 6 - baigtas, 8 - atšauktas arba baigtas. status_name atskiria laukimą, gautą, baigtą, atšauktas, baigtas.
Gavę kodai lieka prieinami po sesijos uždarymo. dideliems tūriams naudokite REST /activations/{id}/sms su after_id.
Po skaičiaus be SMS Jis ištrintas, getStatus ir getSms Grįžimas STATUS_CANCEL; getSmsFull grąžina uždarą statusą, tuščią telefoną ir tuščią sms Įrašas . REST /activations/{id} ir /sms Grįžimas 404 NO_ACTIVATION.

GETgetSmsSMS kaip tekstinio srauto

Grąžina visą SMS istoriją esamiems klientams sričių formatu.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`id`*	integer	Jūsų sesijos ID, gautas, kai buvo išduotas numeris.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getSms.

Pavyzdinis prašymas

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)

Atsakymai

Žinutė

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

Laukiama

STATUS_WAIT_CODE

Atšaukimas arba pabaiga

STATUS_CANCEL

Žinutės formatas: laikas, kodas, tekstas.Daugelis pranešimų atskiriamas kolonomis.
Savo tekstą SMS gali būti kolonų ir vertikalių juostų. patikimai parsinguoti, naudokite getSmsFull.

GETgetServicesPaslaugos

Paslaugų kodai. Atsakymas yra ribotas API raktų srityje.

Direktorius

Leidyba…

JSON ↗

Paslaugų katalogas yra pasidalintas tarp tiekėjo. numerių prieinamumas tikrinamas atskirai.

Galite apriboti raktą konkrečioms paslaugoms, šalims ir teikėjams. tuštieji sąrašai leidžia visus turimus variantus.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`country`	integer	Paimkite ID iš getCountries.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getServices.

Pavyzdinis prašymas

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())

Atsakymai

Paslaugos

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

Paslaugų katalogas yra pasidalintas tarp tiekėjo. numerių prieinamumas tikrinamas atskirai.

GETgetCountriesŠalys

ID, vardai ir skambučių kodai pasirinktoje kanalo šalyse.

Direktorius

Leidyba…

JSON ↗

Galite apriboti raktą konkrečioms paslaugoms, šalims ir teikėjams. tuštieji sąrašai leidžia visus turimus variantus.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getCountries.

Pavyzdinis prašymas

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())

Atsakymai

Šalys

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

GETgetOperatorsOperatorių

Galimi operatoriai: API ID, pavadinimas ir atlygio sulaikymo laikotarpis.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`country`	integer	Paimkite ID iš getCountries.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getOperators.

Pavyzdinis prašymas

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())

Atsakymai

Operatorių

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

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

GETgetRewardsApdovanojimai SMS

Kainos priklauso nuo šalies. Visos lentelės sumos yra už mokamą SMS.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`country`	integer	Paimkite ID iš getCountries.
`service`	string	Paslaugų kodai. Atsakymas yra ribotas API raktų srityje.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getRewards.

Pavyzdinis prašymas

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())

Atsakymai

JSON

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

{}

{}

USD tarifų sumos grąžinamos kaip tikslios dešimties juostelės su 8 dešimties vietomis:
Įgalinti paslaugų teikėjai, prieinami jūsų raktui.
country ID → service code → operator ID → reward (USD)

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

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

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.
`service`*	string	Код сервиса из getServices.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getTopCountriesByService.

Pavyzdinis prašymas

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())

Atsakymai

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

Ключ в примере	Aprašymas	Direktorius
`["12"], ["36"]`	Šalies 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 не задаёт места в рейтинге.

GETgetBalanceNaudotojo likutis

Papildomas SMScash: turimas balansas, atsižvelgiant į akrualus, atskaitos premijas ir mokėjimo prašymus.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getBalance.

Pavyzdinis prašymas

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)

Atsakymai

Likutis

ACCESS_BALANCE:0.00

getBalance grąžina prieinamumą USD balans su mažiau 8 dešimtinė vieta.
Galima išsiimti tik lėšas, kurių sulaikymo laikotarpis pasibaigė.

GETgetHoldBalanceSulaikyta

Gavus SMS, pajamos sulaikomos tiekėjo nustatytam laikotarpiui. Nurodytą dieną suma automatiškai tampa prieinama išsiimti.

Parametrai

parametrų	Tipas	Aprašymas
`api_key`*	string	Asmeninis naudotojo API raktas.

* Reikalingas parametras. visose prašymuose taip pat perduodamas veiksmas =getHoldBalance.

Pavyzdinis prašymas

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)

Atsakymai

Sulaikyta

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
Galima išsiimti tik lėšas, kurių sulaikymo laikotarpis pasibaigė.

Atsakymų kodai ir pakartotiniai prašymai

Į handler_api.pp verslo rezultatai paprastai atsiranda su HTTP 200. Patikrinkite kūno tekstą. aplankai ir getSmsFull grąžinamas JSON jei sėkmingai; klaidų yra visada tekstas.

Kodas	HTTP	Priežastis ir kitas žingsnis
`TARIFF_NOT_CONFIGURED`	200	Palūkanų norma dar nėra nustatytaSkaičius skiriant bus pradėtas, kai SMS atlyginimai yra konfigūruoti.
`COUNTRY_BLOCKED`	200	Šio šalies numerių paskirstymas yra užblokuotas.Pasirinkite kitą šalį.
`BAD_SERVICE`	200	Šio paslaugų numeris yra užblokuotas.Pasirinkite kitą paslaugą.
`PROVIDER_NOT_READY`	200	Numerų paskirstymas laikinai nepateikiamasAtnaujinkite API katalogus.
`BAD_KEY`	400	Nėra api_key arba negalima formata.Patikrinkite raktą prašyme.
`INVALID_API_KEY`	401	Atsisiųsti sąskaitą, atšaukti arba sąskaita yra išjungta.Sukurkite galiojantį API raktą.
`BAD_COUNTRY`	400	Šalis trūksta arba ne teigiamas skaičius.Paimkite ID iš getCountries.
`BAD_SESSION_DURATION`	400	Telefoniniai numeriai išduodami tiksliai 20 minučių.Tikrinimas session_duration.
`BAD_REQUEST`	400	Peržiūrėkite prašymo laukus.Prašome ištaisyti Jūsų prašymą.
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Nežinomas arba neįgali katalogas elementas.Atnaujinkite API katalogus.
`BAD_NUMBER`	200	Neteisingas skaičius formatas.Įveskite numerį skaitmenimis.
`BAD_ACTION / BAD_STATUS`	200	Nežinomas komandos, ID ar operacijos.Peržiūrėkite nustatymus.
`EMPTY_POOL`	200	Šiuo metu nėra jokių atitinkamų telefono numeriai.Pakartokite po 10-30 sekundės arba keisti filtrus.
`NUMBER_IN_USE`	200	Konkrečiojo skaičiaus užima aktyvus posėdis.Užbaigti sesiją arba pasirinkti kitą numerį.
`NO_ACTIVATION`	200	Sėkmė ar ankstesnis numeris nepriklauso jūsų sąskaitai.Patikrinkite ID ir raktą.
`SESSION_CLOSED / SMS_REQUIRED`	200	Valstybės perėjimas šiuo metu nėra prieinamas.Patikrinkite SMS sąlygas ir prieinamumą.
`SCOPE_BLOCKED`	200	Paslauga, šalis ar pardavėjas nėra leidžiamas raktui.Atnaujinkite API raktų apimtį.
`INTERNAL_ERROR`	500	Laikinosios serverio arba pardavėjo klaidos.Kontaktai ir pagalba · X-Request-ID
`ALLOCATION_PENDING`	200	LaukiamagetActiveActivations · getStatus
`ALLOCATION_UNCERTAIN`	200	Automatinis atleidimas neįjungtas, kad būtų išvengta antrojo numero paskirstymo.Automatinis atleidimas neįjungtas, kad būtų išvengta antrojo numero paskirstymo.

Kitas dalykas grąžina objektą {"error":{"code":"…","message":"…"}} ir reguliarių HTTP statuso 400/401/403/404/409/503.

JSON

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Peržiūrėkite prašymo laukus.",
    "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.

Naujų integracijų laukia

USD tarifų sumos grąžinamos kaip tikslios dešimties juostelės su 8 dešimties vietomis: 0.00300000 USD.

Valiutos balansas yra USD. prašymo ir atsakymo schemos yra prieinamos OpenAPI.

Atsisiųsti USDT · TRC20Išmokos trunka nuo 1 iki 45 dienų. Išsiėmimo mokestis yra 4 $. Jis išskaičiuojamas iš prašomos sumos. Gavus SMS, pajamos sulaikomos tiekėjo nustatytam laikotarpiui. Nurodytą dieną suma automatiškai tampa prieinama išsiimti. Galima išsiimti tik lėšas, kurių sulaikymo laikotarpis pasibaigė.

GET/api/v1/catalogPaslaugos ir šalys

GET/api/v1/tariffsSMS atlyginimo tarifai pagal šalį

GET/api/v1/offersPalūkanos ir apdovanojimai

GET/api/v1/servicesDirektorius

GET/api/v1/countriesDirektorius

GET/api/v1/operatorsDirektorius

GET/api/v1/availability?country=1Numeris prieinamumas

POST/api/v1/activationsNaujoji sesijos

GET/api/v1/activations/batch?ids=42,43Patikrinti kelis numerius

GET/api/v1/activationsPaskutinis 200 sesijų: apimtis = istorija, laukimas ar visi

GET/api/v1/activations/{id}Sesijos ir pranešimai

GET/api/v1/activations/{id}/sms?after_id=0&limit=100Naujas SMS su kurzoru

POST/api/v1/activations/{id}/retryLaukiame SMS

POST/api/v1/activations/{id}/finishUžbaigimas

POST/api/v1/activations/{id}/cancelAtšaukti

POST/api/v1/activations/repeatAtgal numeris

GET/api/v1/keysAPI raktas

POST/api/v1/keysSukurkite raktą

PATCH/api/v1/keys/{id}Pakeisti vardą ar politiką

DELETE/api/v1/keys/{id}Atsisakymas raktas

GET/api/v1/referralsReferencinis kodas ir pelnas

GET/api/v1/summaryBalanas ir santrauka

GET/api/v1/balanceSulaikyta

GET/api/v1/ledgerUždirbti Ledger

GET/api/v1/withdrawalsMokėjimo prašymai

POST/api/v1/withdrawalsSukurkite prašymą

GET/api/v1/statisticsBendrosios statistikos

GET/api/v1/earnings/holdsPajamų sulaikymas

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

Išsaugoti next_cursor ir perduoti jį kaip after_id. Jei has_more=true, kitą puslapį galima nedelsdami skaityti. ribojimas: 1–200. Sesijas ir SMS turi tik savininkui.