Početak

API Документација

Бројеви, поруке и приход, директно из ваше апликације.

GET

Počnite sa jednim zahtevom

13 · API КомандиREST + handler_api.phpJSON / plain text · Bearer

Stvorite jedan API Кључ у вашем тастатури, добијте број и проверите за поруке сваки 20 Плаћање се прикупља када је SMS са кодом долази; читање га поново не утиче на вашу равнотежу.

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

компатибилност API База URLhttps://smscash.org/stubs/handler_api.php

Служба је живателефонски број , SMS Доступни су и приход, а приход је доступан у USDT на TRC20Плаћања узимају између 1 и 45 дана дана .

Брзи почетак · REST / cURL

curl -X POST 'https://smscash.org/api/v1/activations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: request-unique-001' \
  -d '{"service":"go","country":86}'

Алтернативна компатибилна интерфејс адреса: /handler_api.php. постојеће интеграције РЕСТ-а и даље раде.

REST API

Израда захтева

cURL · Go · JS · Python

ЗахтевУслуге APIземља APIОператор operatorСофтверски код власника рефIdempotency-Key

Idempotency-Key: UUID · POST · 8–128

Аутоматски избор: највише кодова у последњем сату, затим у 24 сата. Нема бројева: следећи оператер.

cURL

curl --max-time 15 --fail-with-body -X POST 'https://smscash.org/api/v1/activations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: request-unique-001' \
  --data '{"service":"go","country":86}'

package main

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

func main() {
  payload := []byte("{\"service\":\"go\",\"country\":86}")
  req, err := http.NewRequest("POST", "https://smscash.org/api/v1/activations", bytes.NewReader(payload))
  if err != nil { panic(err) }
  req.Header.Set("Authorization", "Bearer " + os.Getenv("SMSCASH_API_KEY"))
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("Idempotency-Key", "request-unique-001")
  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) } // Keep the same operation key after a network error.
  defer res.Body.Close()
  body, err := io.ReadAll(res.Body)
  if err != nil { panic(err) }
  if res.StatusCode >= 300 {
    fmt.Fprintf(os.Stderr, "HTTP %d, request_id=%s\n%s\n", res.StatusCode, res.Header.Get("X-Request-ID"), body)
    os.Exit(1)
  }
  fmt.Println(string(body))
}

JavaScript

// Node.js 18+: set SMSCASH_API_KEY in your environment.
const response = await fetch("https://smscash.org/api/v1/activations", {
  method: "POST",
  headers: {
    Authorization: 'Bearer ' + process.env.SMSCASH_API_KEY,
    'Content-Type': 'application/json',
    'Idempotency-Key': "request-unique-001",
  },
  body: JSON.stringify({
  "service": "go",
  "country": 86
}),
  signal: AbortSignal.timeout(15000),
  redirect: 'error',
});
const result = await response.json();
if (!response.ok) {
  const error = result.error || {};
  console.error(response.status, error.code, error.hint, error.request_id);
  throw new Error(error.message || 'API error');
}
console.log(result);
// SMS codes are strings: keep leading zeros. Never retry writes automatically.

Python

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

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

headers = {
    'Authorization': 'Bearer ' + os.environ['SMSCASH_API_KEY'],
    'Content-Type': 'application/json',
    'Idempotency-Key': "request-unique-001",
}
request = urllib.request.Request(
    "https://smscash.org/api/v1/activations",
    headers=headers,
    data="{\"service\":\"go\",\"country\":86}".encode('utf-8'),
    method="POST",
)
try:
    with urllib.request.build_opener(NoRedirect).open(request, timeout=15) as response:
        result = json.load(response)
    print(result)
except urllib.error.HTTPError as error:
    details = json.load(error).get('error', {})
    print(error.code, details.get('code'), details.get('hint'), details.get('request_id'))
    raise
# No automatic retries; SMS codes remain strings.

API Кључ

Кључ се не чува. Ова провера не додељује бројеве.

Остали за нове интеграције

Услуге и земље

Избор услуге и земље. плаћање по SMS To zavisi od zemlje.

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)

Добијте број

REST

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

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

Аутоматски избор: највише кодова у последњем сату, затим у 24 сата. Нема бројева: следећи оператер.

REST

201: new session · 200: replay of the same operation
service + country OR offer_id · duration_minutes: 20
ref: software owner code (optional)
operator: public ID (e.g. 1 for Operator 1), optional · any/0: automatic
country: integer · service: string · SMS code: string

Број је важећи за 20 Минута је SMS Проверено је свако 20 секунде. можете одмах да откажете.

Провера више бројева

REST

GET /api/v1/activations/batch?ids=42,43
Authorization: Bearer YOUR_API_KEY

JSON

{
  "rows": [
    {
      "id": 42,
      "found": true,
      "phone": "12025550123",
      "status": "received",
      "service": "go",
      "country_id": 86,
      "provider_id": 1,
      "operator": 1,
      "expires_at": "2026-10-10T12:15:00Z",
      "sms_count": 1,
      "code": "001234",
      "last_sms": {
        "id": 101,
        "code": "001234",
        "sender": "Service",
        "text": "Code: 001234",
        "received_at": "2026-10-10T12:01:00Z"
      }
    },
    {
      "id": 43,
      "found": false,
      "error": {
        "code": "NO_ACTIVATION",
        "message": "Session not found."
      }
    }
  ],
  "as_of": "2026-10-10T12:01:00Z",
  "poll_interval_seconds": 20
}

REST

ids: 1–100 positive session IDs, separated by commas
Input order preserved · duplicates removed
Foreign, unavailable or out-of-scope IDs: found=false
Read only · no supplier requests · last_sms is the latest message

Стање · Задржано

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 — Доступно; held_balance — Задржано. USD · 8

Могу се исплатити само средства чији је период задржавања завршен.

Клијенти спремни за употребу

JavaScript / Node.js ↓Python ↓

JavaScript · Node.js 18+

import {SmScash, SmScashError} from './smscash.mjs';
import {randomUUID} from 'node:crypto';

const api = new SmScash(process.env.SMSCASH_API_KEY);
const catalog = await api.catalog({service: 'go', country: 86});
console.log(catalog.rows);

// Save this key before sending; keep it for retries of this operation.
const requestKey = randomUUID();
const session = await api.createNumber({service: 'go', country: 86}, requestKey);
// After 20 seconds:
const messages = await api.sms(session.id, {afterId: 0});
console.log(messages.sms);
const statuses = await api.batch([session.id]);
const held = await api.holdBalance();
console.log(held); // Exact USD string

Python 3.9+

import os
import uuid
from smscash import SmScash, SmScashError

api = SmScash(os.environ['SMSCASH_API_KEY'])
catalog = api.catalog(service='go', country=86)
print(catalog['rows'])

# Save this key before sending; keep it for retries of this operation.
request_key = str(uuid.uuid4())
session = api.create_number({'service': 'go', 'country': 86}, request_key)
# After 20 seconds:
messages = api.sms(session['id'], after_id=0)
print(messages['sms'])
statuses = api.batch([session['id']])
held = api.hold_balance()
print(held) # Exact USD string

SDK

me() · balance() · holdBalance()/hold_balance() · catalog() · activation() · sms() · batch()
createNumber(parameters, requestKey) / create_number(parameters, request_key)
setStatus(id, "cancel") / set_status(id, "cancel")
setStatus(id, "retry", requestKey) / set_status(id, "retry", request_key)
Timeout: 15 s · no dependencies · no automatic retries
Error: code · status · hint · requestId/request_id · retryable
ALLOCATION_UNCERTAIN: contact support with request_id; never retry automatically.

SMS-Activate / HeroSMS

SMS-Activate · компатибилност API База URLhttps://smscash.org/sms-activate/stubs/handler_api.php

HeroSMS · компатибилност API База URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Лични API кључ корисника.

Избор услуге и земље. плаћање по SMS To zavisi od zemlje.

Код	Опис
`getNumber / getNumberV2`	Добијте број
`getStatus / getStatusV2`	Добијте најновији код
`setStatus / finishActivation / cancelActivation`	Управљање сесијом
`getPrices / getNumbersStatus`	Проверите доступност
`getRewards (SMScash)`	Награда за SMS
`getServicesList / getServices`	Услуге
`getCountries / getOperators`	Услуге и земље
`getActiveActivations`	Сесије
`getBalance`	Стање корисника
`getHoldBalance (SMScash)`	Задржано

cost = 0 USD · activationCost = 0 USD
reward — Награда за SMS

HeroSMS · cURL

curl --get 'https://smscash.org/hero-sms/stubs/handler_api.php' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'action=getNumberV2' \
  --data-urlencode 'service=go' \
  --data-urlencode 'country=86' \
  -H 'Idempotency-Key: request-unique-001'

Одговори

{
  "activationId": "42",
  "phoneNumber": "393331234567",
  "activationCost": 0,
  "currency": 840,
  "countryCode": 86,
  "canGetAnotherSms": true,
  "activationTime": "2026-10-11T12:00:00Z",
  "activationEndTime": "2026-10-11T12:15:00Z",
  "reward": "0.00300000"
}

SMS-Activate / HeroSMS

GET or POST application/x-www-form-urlencoded
api_key · action · service · country · ref (optional)
setStatus: 1 → ACCESS_READY · 3 → ACCESS_RETRY_GET
           6 → ACCESS_ACTIVATION · 8 → ACCESS_CANCEL
getStatus: STATUS_WAIT_CODE · STATUS_OK:001234 · STATUS_CANCEL
getStatusV2: {"verificationType":1,"sms":null,"call":null}
getServicesList: {"status":"success","services":[{"code":"go","name":"Google"}]}
getCountries: {"86":{"id":86,"eng":"Italy","visible":1,"retry":1,"rent":0}}
getPrices: {"86":{"go":{"cost":0,"count":12,"reward":"0.00300000","currency":"USD"}}}
getRewards: {"59":{"vi":{"1":"0.01000000"}}}
getRewards filters: country · service · operator (optional); any/0: all permitted providers
getActiveActivations: start=0 · limit=1–100 · activeActivations / data
Business/key errors: HTTP 200 + plain text · server errors: HTTP 500
Availability: actual supplier pool, shared cache up to 20 s; not a reservation
No automatic retries after a transport error or ALLOCATION_UNCERTAIN.
Keep the original Idempotency-Key and parameters.
Unsupported: rent · calls · forwarding · multiple services per number · prolong
Unsupported options return BAD_REQUEST; unsupported actions return BAD_ACTION.
SMScash keys and country/service codes; configure this base URL in your software.

Број је важећи за 20 Минута је SMS Проверено је свако 20 секунде. можете одмах да откажете.

Аутентификација и ретроверзије

REST: Главни Authorization: Bearer YOUR_API_KEY. компатибилни интерфејс: параметри api_key и actionKoristite HTTPS

Да бисте управљали API кључевима, унесите свој налог.

∞Захтеви / минута по рачуну

∞Истовремени сесије

API честота захтева и број телефонских бројева су неограничени. нема дневне или сатне квоте.

Број је важећи за 20 Минута је SMS Проверено је свако 20 секунде. можете одмах да откажете.

У осталом, јединствено Idempotency-Key Потребно је за распоређивање бројева, понављање распоређивања, ретри и захтеви за плаћање. то је опционално, али се препоручује у handler_api.php. Поново користите кључ приликом ретрирања мрежне захтеве; користите нови кључ за нову операцију.

API ključni skop

Можете ограничити кључ на одређене услуге, земље и провајдере. празни листи омогућавају све доступне опције.

JSON

{
  "label": "Мој софтвер",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} Промена имена и политике потпуно. тајна се показује само када је створен.

10% у укупном. 5% + 5% са софтверским кодом.

Када издате број, молимо вас да ref власник софтвера. захтев је овлашћен кључем извршиоца. код се налази у одељку "Референце" и у GET /api/v1/referrals → software_ref.

Захтев	Позива	Софтвер
Без реф	10%	—
са реф	5%	5%
са реф, без референца	—	5%

Платформа плаћа бонус без смањења прихода корисника. Власник софтвера и референтник могу бити иста особа.

Термини су фиксирани када се сесија креира; читање SMS и retry Немојте их мењати. пролазе ref у поновљеном сесији. у рачуну царине, корисник награђује USD 0.003 даје USD 0.00015 сваки до власника софтвера и референца. укупни бонус је USD 0.00030.

API Команди

11 XVBC- стил метода плус ваш SMScash Уравнотежа .

GETgetNumberДобијте број

Креира сесију и резервише број који је доступан за корисника.Награда и референтни примаоци су фиксирани на распореду; Награда се кредитира када SMS са кодом стигне.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.
`service`*	string	Доступни код услуга.Одговор је ограничен на подручје API Кључ је
`country`*	integer	Узми ID од getCountries.
`operator`	string	Узми ID од operators/getOperators (API). `operator=1 · any/0`
`session_duration`	integer	Сесија траје 20 минута. прођете 20 или пропустите овај параметар.
`with_operator`	integer	1 додаје ID оператера у одговор; 0 или изостављен параметар враћа три дела.
`ref`	string	Јавни код власника софтвера: 5% За њега и 5% За гостију, без ref - 10% За гостера .

* Потребан параметар. у свим захтевима такође пролази акција =getNumber.

Пример захтева

curl

curl 'https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1' \
  -H 'Idempotency-Key: request-unique-001'

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) }
  req.Header.Set("Idempotency-Key", "request-unique-001")
  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", {
  headers: {"Idempotency-Key": "request-unique-001"}
});
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",
    headers={"Idempotency-Key": "request-unique-001"},
    timeout=15,
)
print(response.status_code, response.text)

Одговори

Број издати

ACCESS_NUMBER:42:380670000000:1

Нема доступних бројева

EMPTY_POOL

Аутоматски избор: највише кодова у последњем сату, затим у 24 сата. Нема бројева: следећи оператер.
Пролази Idempotency-Key: исто захтева са истом кључам враћа претходну сесију. Измењање параметра позива IDEMPOTENCY_CONFLICT.
Бројна земља без базена даје ЕМПТИ_ПООЛ; погрешан формат земље је БАД_КОУНТРИ.
Кључ за избрисану сесију остаје у употреби: репродукција распореда са тим кључем враћа СЕСИЈ_ЦЛОСЕН и не издаје други број.
Резултат распореда није потврђен.Автоматски повлачење је онемогућено да би се избегло распоређивање другог броја.

GETgetNumbersStatusПроверите доступност

Доступни телефонски бројеви по служби и земљи.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.
`country`*	integer	Узми ID од getCountries.

* Потребан параметар. у свим захтевима такође пролази акција =getNumbersStatus.

Пример захтева

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

Одговори

Доступни бројеви

{
  "go_0": 0
}

Суфикс _0 значи избор без одређеног оператора.
Доступност се односи на укупни базен добављача.Изабрани канал се проверава када се распореди број.

GETgetStatusДобијте најновији код

Једноставна захтева за статус сесије и последње SMS Код. водећи нурови у коду су сачувани.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.
`id`*	integer	ИД ваше сесије, примљен када је број издато.

* Потребан параметар. у свим захтевима такође пролази акција =getStatus.

Пример захтева

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)

Одговори

Чекајући

STATUS_WAIT_CODE

Код примљен

STATUS_OK:001234

Укидање или истека

STATUS_CANCEL

Не пронађе

NO_ACTIVATION

Пол сваких 20 секунди. читање поруке поново не ствара још плаћање.
После retry Стари код се не враћа: getStatus Čekaj na sledeće SMS.
После броја без SMS и уклоњено је, getStatus и getSms Враћање STATUS_CANCEL; getSmsFull Враћа затворени статус, празан телефон и празан sms Листа је. REST /activations/{id} и /sms Враћање 404 NO_ACTIVATION.

GETsetStatusУправљање сесијом

Завршене, отклањања или поновно чекање SMSРаспоред сесије остаје исти.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.
`id`*	integer	ИД ваше сесије, примљен када је број издато.
`status`*	integer	3 - сачекајте следећи код без продужења сесије; 6 - завршетак након SMS; 8 Одмах је отказао.

* Потребан параметар. у свим захтевима такође пролази акција =setStatus.

Пример захтева

curl

curl 'https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3' \
  -H 'Idempotency-Key: request-unique-001'

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) }
  req.Header.Set("Idempotency-Key", "request-unique-001")
  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", {
  headers: {"Idempotency-Key": "request-unique-001"}
});
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",
    headers={"Idempotency-Key": "request-unique-001"},
    timeout=15,
)
print(response.status_code, response.text)

Одговори

Čekajući SMS

ACCESS_RETRY_GET

Завршена

ACCESS_ACTIVATION

Отклањање

ACCESS_CANCEL

Повратак чека следећи код у року од 20 минута. излаз и време истека се не мењају.
За статус =3 Коришћење Idempotency-Key: понављање захтева неће поново поставити нови код који је већ примио. SMS Остаје доступна.
Анулација не уклања награде које су већ зарађене.
Само број са SMS Код се чува у историји. отклањени и истекли бројеви без кода су избрисани.

GETgetRepeatNumberПоново извуците исти број

Отвори нова сесија са одређеним бројем из ваше историје. можете изабрати другу доступну услугу у истој земљи.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.
`number`*	string	Само бројеви и опционални водич + су дозвољени.
`service`*	string	Доступни код услуга.Одговор је ограничен на подручје API Кључ је
`session_duration`	integer	Сесија траје 20 минута. прођете 20 или пропустите овај параметар.
`with_operator`	integer	1 додаје ID оператера у одговор; 0 или изостављен параметар враћа три дела.
`ref`	string	Јавни код власника софтвера: 5% За њега и 5% За гостију, без ref - 10% За гостера .
`operator`	string	Узми ID од operators/getOperators (API). `operator=1 · any/0`

* Потребан параметар. у свим захтевима такође пролази акција =getRepeatNumber.

Пример захтева

curl

curl 'https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go' \
  -H 'Idempotency-Key: request-unique-001'

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) }
  req.Header.Set("Idempotency-Key", "request-unique-001")
  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", {
  headers: {"Idempotency-Key": "request-unique-001"}
});
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",
    headers={"Idempotency-Key": "request-unique-001"},
    timeout=15,
)
print(response.status_code, response.text)

Одговори

Нова сесија

ACCESS_NUMBER:43:380670000000

Broj je još uvek zauzet

NUMBER_IN_USE

Прво, завршите или отклоните вашу тренутну сесију.Ако је број заузет, поновно излазак се не врши.
Нови састанак добија нови ID А садашњи тариф. стари SMS Не копирају се у њега. ref Поново се поставља.
SMScash дозвољава понављање само бројева из историје овог рачуна. земља се идентификује бројем.
Кључ за избрисану сесију остаје у употреби: репродукција распореда са тим кључем враћа СЕСИЈ_ЦЛОСЕН и не издаје други број.

GETgetSmsFullSMS sa JSON

Структурирана историја свих порука са идентификацијом, пошаљицом, кодом, текстом и земљом, услугом и подацима о добављачу.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.
`id`*	integer	ИД ваше сесије, примљен када је број издато.

* Потребан параметар. у свим захтевима такође пролази акција =getSmsFull.

Пример захтева

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

Одговори

JSON

{
  "success": true,
  "session_id": 42,
  "phone": "380670000000",
  "status": 1,
  "status_name": "received",
  "sms_count": 1,
  "sms": [
    {
      "id": 101,
      "external_id": "message-101",
      "sender": "Service",
      "code": "001234",
      "text": "Код подтверждения: 001234",
      "received_at": "2026-10-09T12:00:00Z",
      "country": {
        "id": 86,
        "name": "Italy"
      },
      "service": {
        "code": "go",
        "name": "Google"
      },
      "provider": {
        "id": 1,
        "name": "Оператор 1"
      }
    }
  ],
  "expires_at": "2026-10-09T12:20:00Z"
}

Преферирани формат за интеграцију. запамтите СМС[].ИД да бисте обрадили само нове поруке.
бројни статус SMScash: 1 Активни је , 6 Завршена је , 8 - отклоњена или истекла. status_name Разлике између чекања, примљених, завршених, отказаних, истеканих.
Примљени шифри остаје доступни након затварања сесије. За велике објекти, користи се REST /activations/{id}/sms са after_id.
После броја без SMS и уклоњено је, getStatus и getSms Враћање STATUS_CANCEL; getSmsFull Враћа затворени статус, празан телефон и празан sms Листа је. REST /activations/{id} и /sms Враћање 404 NO_ACTIVATION.

GETgetSmsSMS kao tekst string

Враћа се цео SMS Историја у формат струка за постојеће клијенте.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.
`id`*	integer	ИД ваше сесије, примљен када је број издато.

* Потребан параметар. у свим захтевима такође пролази акција =getSms.

Пример захтева

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)

Одговори

порука

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

Чекајући

STATUS_WAIT_CODE

Укидање или истека

STATUS_CANCEL

Формат поруке: време кода кода текст. више порука је одвојено колоном.
Текст SMS сама може да садржи колоне и вертикалне траке. за поуздано парсинг, користи се getSmsFull.

GETgetServicesУслуге

Доступни код услуга.Одговор је ограничен на подручје API Кључ је

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.
`country`	integer	Узми ID од getCountries.

* Потребан параметар. у свим захтевима такође пролази акција =getServices.

Пример захтева

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

Одговори

Услуге

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

Дијалог услуга је подељен кроз добављача. број доступности се проверава одвојено.

GETgetCountriesДржаве

ИД, имена и позивни кодови за земље у изабраном каналу.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.

* Потребан параметар. у свим захтевима такође пролази акција =getCountries.

Пример захтева

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

Одговори

Државе

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

GETgetOperatorsоператори

Доступни оператери: API ID, назив и период задржавања накнаде.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.
`country`	integer	Узми ID од getCountries.
`operator`	string	Узми ID од operators/getOperators (API). `operator=1 · any/0`

* Потребан параметар. у свим захтевима такође пролази акција =getOperators.

Пример захтева

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

Одговори

оператори

{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}

Узми ID од operators/getOperators (API).

GETgetRewardsНаграда за SMS

Ставка зависи од земље.Сви столови су по плаћању SMS.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.
`country`	integer	Узми ID од getCountries.
`service`	string	Доступни код услуга.Одговор је ограничен на подручје API Кључ је
`operator`	string	Узми ID од operators/getOperators (API). `operator=1 · any/0`

* Потребан параметар. у свим захтевима такође пролази акција =getRewards.

Пример захтева

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

Одговори

JSON

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

{}

{}

USD tarifni iznosi se vraćaju kao tačni desimalni redovi sa 8 desimalnih mesta:
Дозвољени провајдери доступни за ваш кључ.
country ID → service code → operator ID → reward (USD)

GETgetBalanceСтање корисника

Додавање SMScash: доступни баланс узимајући у обзир акруле, референтне бонусе и захтеве за плаћање.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.

* Потребан параметар. у свим захтевима такође пролази акција =getBalance.

Пример захтева

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)

Одговори

Стање

ACCESS_BALANCE:0.00

getBalance врати доступно USD баланс са до 8 децимални места.
Могу се исплатити само средства чији је период задржавања завршен.

GETgetHoldBalanceЗадржано

Након пријема SMS поруке, зарада се задржава током периода који одреди добављач. На наведени датум износ аутоматски постаје доступан за исплату.

параметри

параметри	Тип	Опис
`api_key`*	string	Лични API кључ корисника.

* Потребан параметар. у свим захтевима такође пролази акција =getHoldBalance.

Пример захтева

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)

Одговори

Задржано

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
Могу се исплатити само средства чији је период задржавања завршен.

Кодове одговора и понављање захтева

Унутра handler_api.фп пословни резултати обично долази са HTTP 200. Провери текст тела и директорије getSmsFull врати се JSON Ако је успешно; грешке су увек текст.

Код	HTTP	Разлог и следећи корак
`TARIFF_NOT_CONFIGURED`	200	Cene još uvek nisu postavljeneБрој прикупљања ће почети једном SMS Награде су конфигурисане.
`COUNTRY_BLOCKED`	200	Број распореда за ову земљу је блокиран.Изаберите другу земљу.
`BAD_SERVICE`	200	Број распореда за ову услугу је блокиран.Изаберите другу услугу.
`PROVIDER_NOT_READY`	200	Број распореда је привремено недоступаносвежавају се API Каталог је
`BAD_KEY`	400	Не api_key или неисправан формат.Проверите кључ у захтеву.
`INVALID_API_KEY`	401	Кључ је непознат, отклоњен или рачун је онемогућен.Успостављање важећег API Кључ је
`BAD_COUNTRY`	400	Država nedostaje ili ne ima pozitivan broj.Узми ID од getCountries.
`BAD_SESSION_DURATION`	400	Телефонски бројеви се издају тачно 20 минута.Исправљање session_duration.
`BAD_REQUEST`	400	Неисправан параметр или Idempotency-Key.Molim vas da ispravite Vašu zahtev.
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Непознати или инвалидирани директоријски елемент.освежавају се API Каталог је
`BAD_NUMBER`	200	Неправилан број формат.Унесите број у дигитима.
`BAD_ACTION / BAD_STATUS`	200	Непозната команда, идентификатор или операција.Проверите подешавања
`EMPTY_POOL`	200	Trenutno nema odgovarajućih telefonskih brojeva.Понављају се након 10-30 секунде или промене филтера.
`NUMBER_IN_USE`	200	Посебан број је заузет активном сесијом.Завршите сесију или изаберите други број.
`NO_ACTIVATION`	200	Сесију или претходни број не припада вашем рачуну.Проверите идентификацију и кључ.
`SESSION_CLOSED / SMS_REQUIRED`	200	Државна транзиција је тренутно недоступна.Проверите услов и доступност SMS.
`SCOPE_BLOCKED`	200	Услуга, земља или продавац није овлашћен за кључ.Ажурирајте на API Кључ је опсег.
`IDEMPOTENCY_CONFLICT`	200	Овај кључ за претрагу већ је повезан са другим параметрима.За нову операцију, направи другу Idempotency-Key.
`BAD_REF / SELF_REF`	400	Софтверски код је непознат, деактивиран или припада самој корисници.Проверите код власника софтвера.
`INTERNAL_ERROR`	500	Привремена грешка сервера или продавца.Понављање са затркањем и истом Idempotency-Key.
`ALLOCATION_PENDING`	200	Додељење бројева већ је напред. Покушајте са истом Idempotency-Key.Додељење бројева већ је напред. Покушајте са истом Idempotency-Key.
`ALLOCATION_UNCERTAIN`	200	Резултат распореда није потврђен.Автоматски повлачење је онемогућено да би се избегло распоређивање другог броја.Резултат распореда није потврђен.Автоматски повлачење је онемогућено да би се избегло распоређивање другог броја.

Остатак враћа објекат {"error":{"code":"…","message":"…"}} и редовни ХТТП статуси 400/401/403/404/409/503.

JSON

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Проверите поље за захтеве.",
    "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.

Остали за нове интеграције

USD tarifni iznosi se vraćaju kao tačni desimalni redovi sa 8 desimalnih mesta: 0.00300000 USD.

Валута баланса је USD. схеми за захтеве и одговоре су доступни у OpenAPI.

Укидање у USDT · TRC20Исплате трају од 1 до 45 дана. Накнада за исплату износи 4 $. Одузима се од траженог износа. Након пријема SMS поруке, зарада се задржава током периода који одреди добављач. На наведени датум износ аутоматски постаје доступан за исплату. Могу се исплатити само средства чији је период задржавања завршен.

GET/api/v1/catalogУслуге и земље

GET/api/v1/tariffsSMS nagrada po zemlji

GET/api/v1/offersЦена и награде

GET/api/v1/servicesДиректорија

GET/api/v1/countriesДиректорија

GET/api/v1/operatorsДиректорија

GET/api/v1/availability?country=1Број доступности

POST/api/v1/activationsНова сесија

GET/api/v1/activations/batch?ids=42,43Провера више бројева

GET/api/v1/activationsПоследњих 200 сесија: опсег = историја, чекање или све

GET/api/v1/activations/{id}Сесије и поруке

GET/api/v1/activations/{id}/sms?after_id=0&limit=100Нови SMS са курсором

POST/api/v1/activations/{id}/retryČekajući SMS

POST/api/v1/activations/{id}/finishДовршеност

POST/api/v1/activations/{id}/cancelотклањање

POST/api/v1/activations/repeatБрој поновног

GET/api/v1/keysAPI Кључ

POST/api/v1/keysStvorite ključ

PATCH/api/v1/keys/{id}Промена имена или политике

DELETE/api/v1/keys/{id}Одбијање кључа

GET/api/v1/referralsРеферентни код и профит

GET/api/v1/summaryБаланс и резюме

GET/api/v1/balanceЗадржано

GET/api/v1/ledgerПриходни ледгер

GET/api/v1/withdrawalsЗахтеви за плаћање

POST/api/v1/withdrawalsStvorite zahtev

GET/api/v1/statisticsОпшта статистика

GET/api/v1/earnings/holdsЗадржавање зараде

Примање само новог 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": "Код: 001234",
      "sender": "Service",
      "received_at": "2026-10-09T12:00:00Z"
    }
  ],
  "next_cursor": 101,
  "has_more": false
}

Спасите next_cursor и прође га као after_idАко has_more=trueСледеће странице се могу читати одмах. limit: 1–200Сесије и SMS Доступни су само власници.