Започнете со

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

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

GET

Започнете со една побарувачка

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

Создавајте ја 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 интеграции продолжуваат да работат.

REST API

Конструктор на барања

cURL · Go · JS · Python

За побарувањеСлужбата APIЗемја APIОператор operatorСофтверски код на сопственик refIdempotency-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 Зависно е од земјата.

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 Зависно е од земјата.

Кодекс	Опис
`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 и actionКористете го HTTPS

За да ги управувате клучевите на API, влезте го вашиот профил.

∞Заслужување / минута на сметка

∞Седница на истовреме

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

Номинацијата е валидна за 20 Минутите SMS Се провери секој 20 Затоа, можете веднаш да го откажете.

Во остатокот, една уникатна Idempotency-Key е потребен за број распоредување, повторување на распоредување, ретри и плаќање барања. тоа е опционално, но препорачува во handler_api.php. повторно користење на клучот при ретрирање на мрежна побарувачка; користете нов клуч за нова операција.

API Кључна опсег

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

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.
Бројната земја без базен дава EMPTY_POOL; погрешниот формат на земјата е BAD_COUNTRY.
Кључ за избришана сесија останува корисна: репродукцијата на асистенцијата со тој кључ враќа SESSION_CLOSED и не издава друг број.
Резултатот од доделувањето е непотврден.Автоматски ретри е немогуќен за да се избегне доделувањето на вториот број.

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 чека следниот 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)

Одговори

Чекајќи за 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

Новата бројка е зафатена

NUMBER_IN_USE

Прво, завршете или отфрлете ја вашата тековна сесија.Ако бројот е зафатен, повторно извлекување не се извршува.
Новата сесија ќе добие нов ID А сега старите цени се SMS Не се копирани во него. ref Повторно се поставува.
SMScash ви овозможува да повторувате само броеви од историјата на овој налог.
Кључ за избришана сесија останува корисна: репродукцијата на асистенцијата со тој кључ враќа SESSION_CLOSED и не издава друг број.

GETgetSmsFullПодајте SMS како 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"
}

Запомнете SMS[].id за да обработувате само нови пораки.
Бројниот статус на 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.

GETgetSmsДобивање на SMS како текстови

Враќа целосна 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 се враќаат како тачни десетични нијанси со 8 десетични места:
Дозволени провајдери достапни за вашиот клуч.
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	Досега не се утврдени стокитеБројот на доделување ќе започне веднаш штом се конфигурирани 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	Затоа, не постои или не постои позитивен број.Земи ID од getCountries.
`BAD_SESSION_DURATION`	400	Телефонските броеви се издаваат за точно 20 минути.Исправено session_duration.
`BAD_REQUEST`	400	Невалидна параметра или Idempotency-Key.Ве молиме исправете ја вашата побарувачка.
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Непознат или дефектен директориски елемент.Повторно ги освежува API каталозите.
`BAD_NUMBER`	200	Неправилен број формат.Внесете го бројот во дигити.
`BAD_ACTION / BAD_STATUS`	200	Непознат команда, идентификатор или операција.Проверете ги поделувањата.
`EMPTY_POOL`	200	Во моментов не постојат телефонски броеви.Повторете по 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":"…"}} И редовни HTTP статуси 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 се враќаат како тачни десетични нијанси со 8 десетични места: 0.00300000 USD.

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

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

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

GET/api/v1/tariffsSMS награди на цена по земја

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Чекајќи за 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/keysСоздајте ја клучот

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/withdrawalsСоздавање на барање

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 Достапни се само за сопствениците.