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

GET

Започнете с едно искане

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

Създайте API ключ в таблото си, получите номер и проверете за съобщения на всеки 10 секунди. Плащането се кредитира, когато SMS с код пристигне; четенето отново не засяга баланса ви.

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

Съвместимост API база URLhttps://smscash.org/stubs/handler_api.php

Услугата е живаТелефонни номера , SMS Достъпни са печалби, налични са оттегляния USDT на TRC20Плащанията се извършват между 1 и 45 Дни на .

Пример за искане · 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'

Алтернативна съвместима интерфейс адреса: /handler_api.php. Съществуващите REST интеграции продължават да работят.

API

Конструктор на заявки

cURL · Go · JS · Python

Съвместимост API база URLhttps://smscash.org/stubs/handler_api.php

Искане actionУслуги serviceСтраната countryОператор operatorИдентифициране на доставчици, отделими от: operator=1,3. Автоматичен избор: случаен наличен оператор.session_durationСесията продължава 20 минути. преминаване 20 или пропуснете този параметър.with_operator1 добавя ID на оператора в отговора; 0 или липсващ параметър връща три части.Софтуерният собственик на код 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 Ключове

Ключът не се запазва. Тази проверка не разпределя номера.

За нови интеграции

Услуги и държави

Изберете услуга и страна. Плащането по 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)

Получете число

handler_api.php

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

Автоматичен избор: случаен наличен оператор.

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

Номерът е валиден за 20 Минутите са SMS Проверяват се всички 10 Втори, можете да отмените веднага.

Проверка на няколко номера

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

Баланс · Задържани средства

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';

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 · Съвместимост 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'

Отговори

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

Номерът е валиден за 20 Минутите са SMS Проверяват се всички 10 Втори, можете да отмените веднага.

Атентификация и оттегляне

REST: Глава Authorization: Bearer YOUR_API_KEY. Съвместим интерфейс: параметри api_key и actionИзползвайте HTTPS

За да управлявате ключовете на API, въведете акаунта си.

∞Заявления / мин по сметка

∞Съвременни сесии

Фреквенцията на заявките на API и броят на телефонните номера са неограничени. няма дневни или часовни квоти.

Номерът е валиден за 20 Минутите са SMS Проверяват се всички 10 Втори, можете да отмените веднага.

Ключовият обхват на 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 и оттегляне не ги променят. Преминаване 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). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`
`session_duration`	integer	Сесията продължава 20 минути. преминаване 20 или пропуснете този параметър.
`with_operator`	integer	1 добавя ID на оператора в отговора; 0 или липсващ параметър връща три части.
`ref`	string	Публичный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.

* Необходими параметри. във всички искания също преминава действие =getNumber.

Пример за искане

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)

Отговори

Изпратено число

ACCESS_NUMBER:42:380670000000:1

Няма налични номера

EMPTY_POOL

Автоматичен избор: случаен наличен оператор.
Цифровата страна без басейн дава 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'

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)

Отговори

Очакваме SMS

ACCESS_RETRY_GET

завършени

ACCESS_ACTIVATION

отменени

ACCESS_CANCEL

Изтеглянето чака следващия код в рамките на оригиналните 20 минути. изтичането и изтичането на срока на изтичане не се променят.
Отмяна не премахва вече спечелените награди.
Само номера с 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% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`

* Необходими параметри. във всички искания също преминава действие =getRepeatNumber.

Пример за искане

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)

Отговори

Нова сесия

ACCESS_NUMBER:43:380670000000

Броят все още е зает

NUMBER_IN_USE

Първо, завършете или отменете текущата си сесия.Ако броят е зает, повторно изтегляне не се извършва.
Новата сесия получава нов ID и текущата такса. старите SMS не се копират в него. ref се задава отново.
SMScash позволява да се повтарят само числа от историята на този акаунт.
Ключът за изтрита сесия остава използван: презареждането на разпределението с този ключ връща SESSION_CLOSED и не издава друг номер.

GETgetSmsFullSMS като 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": "operator=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.

GETgetSmsSMS като текстово сечение

Повторно връща цялата история на 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.

Директор

Издателство…

JSON ↗

Диалогът за услуги се споделя между доставчика.Номерът за наличност се проверява отделно.

параметри

параметри	Типът	описание
`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Държави

Идентифициране, имена и кодове за обаждане за държавите в избрания канал.

Директор

Издателство…

JSON ↗

параметри

параметри	Типът	описание
`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). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · 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": "operator=1",
    "earnings_hold_days": 45
  }
}

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

GETgetRewardsНаграда за SMS

Цените зависят от страната. Всички столови суми са на платен SMS.

параметри

параметри	Типът	описание
`api_key`*	string	Личен API ключ на потребителя.
`country`	integer	Вземи ID от getCountries.
`service`	string	Отговорът е ограничен до областта на ключа за API.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · 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)

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

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

параметри

параметри	Типът	описание
`api_key`*	string	Личен API ключ на потребителя.
`service`*	string	Код сервиса из getServices.

* Необходими параметри. във всички искания също преминава действие =getTopCountriesByService.

Пример за искане

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

Отговори

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

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

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	Проверете полетата за заявка.Моля, поправете искането си.
`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	Сесията или предишният номер не принадлежи на Вашия акаунт.Проверете ID и ключ.
`SESSION_CLOSED / SMS_REQUIRED`	200	В момента преходът на държавата не е наличен.Проверете условията и наличността на SMS.
`SCOPE_BLOCKED`	200	Услугата, страната или доставчикът не са разрешени за ключа.Актуализиране на обхвата на ключа за API.
`INTERNAL_ERROR`	500	Временна грешка на сървъра или доставчика.Контакти и поддръжка · X-Request-ID
`ALLOCATION_PENDING`	200	чакащиgetActiveActivations · getStatus
`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=100SMS с курсор

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, следващата страница може да бъде прочетана незабавно. 1–200. Сесии и SMS са достъпни само за собственикът.