API Документација
Започнете со една побарувачка
Создавајте ја API клучот во вашата тастатура, добијте број и проверете за пораки секој 10 Плаќањето е кредитирано кога SMS со доаѓање на код; повторно читање не влијае на вашата рамнотежа.
https://smscash.org/api/v1https://smscash.org/stubs/handler_api.phpcurl --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 интеграции продолжуваат да работат.
Конструктор на барања
https://smscash.org/stubs/handler_api.phpcurl --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))
}// 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.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.Клучот не се зачувува. Оваа проверка не доделува броеви.
Останува за нови интеграции
Услуги и земји
Изберете услуга и земја. плаќање по SMS Зависно е од земјата.
GET /api/v1/catalog?service=go&country=86&page=1&page_size=100
Authorization: Bearer YOUR_API_KEY{
"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)
Добивајте број
GET /stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86Автоматски избор: случаен достапен оператор.
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 Затоа, можете веднаш да го откажете.
Проверка на повеќе броеви
GET /api/v1/activations/batch?ids=42,43
Authorization: Bearer YOUR_API_KEY{
"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
}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Салдо · Задржани средства
GET /api/v1/balance
Authorization: Bearer YOUR_API_KEY{
"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
Може да повлечете само средства чиј период на задржување завршил.
Готови клиенти
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 stringimport 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 stringme() · 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
https://smscash.org/sms-activate/stubs/handler_api.phphttps://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 USDreward — Наградата за SMS
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"
}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 Кључна опсег
Можете да го ограничите клучот на одредени услуги, земји и провајдери. празни листи овозможуваат сите достапни опции.
{
"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). 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 '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))
}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);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:1EMPTY_POOL- Автоматски избор: случаен достапен оператор.
- Бројната земја без базен дава EMPTY_POOL; погрешниот формат на земјата е BAD_COUNTRY.
- Кључ за избришана сесија останува корисна: репродукцијата на асистенцијата со тој кључ враќа SESSION_CLOSED и не издава друг број.
- Резултатот од доделувањето е непотврден.Автоматски ретри е немогуќен за да се избегне доделувањето на вториот број.
GETgetNumbersStatusПроверете ја достапноста+
Достапни телефонски броеви по служба и земја.
Параметри
| Параметри | Типот | Опис |
|---|---|---|
api_key* | string | Личен API клуч на корисникот. |
country* | integer | Земи ID од getCountries. |
* Потребен параметар. во сите барања исто така продава акција =getNumbersStatus.
Пример за барање
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))
}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);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 '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))
}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);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_CODESTATUS_OK:001234STATUS_CANCELNO_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 '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))
}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);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)Одговори
ACCESS_RETRY_GETACCESS_ACTIVATIONACCESS_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 '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))
}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);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:380670000000NUMBER_IN_USE- Прво, завршете или отфрлете ја вашата тековна сесија.Ако бројот е зафатен, повторно извлекување не се извршува.
- Новата сесија ќе добие нов ID А сега старите цени се SMS Не се копирани во него. ref Повторно се поставува.
- SMScash ви овозможува да повторувате само броеви од историјата на овој налог.
- Кључ за избришана сесија останува корисна: репродукцијата на асистенцијата со тој кључ враќа SESSION_CLOSED и не издава друг број.
GETgetSmsFullПодајте SMS како JSON+
Структурирана историја на сите пораки со идентификатор, испраќач, код, текст и земја, податоци за услуги и добавувач.
Параметри
| Параметри | Типот | Опис |
|---|---|---|
api_key* | string | Личен API клуч на корисникот. |
id* | integer | Идентификација на вашата сесија, прифатена кога е издаден бројот. |
* Потребен параметар. во сите барања исто така продава акција =getSmsFull.
Пример за барање
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))
}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);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())Одговори
{
"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.
GETgetSmsДобивање на SMS како текстови+
Враќа целосна SMS историја во формат на струја за постоечки клиенти.
Параметри
| Параметри | Типот | Опис |
|---|---|---|
api_key* | string | Личен API клуч на корисникот. |
id* | integer | Идентификација на вашата сесија, прифатена кога е издаден бројот. |
* Потребен параметар. во сите барања исто така продава акција =getSms.
Пример за барање
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))
}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);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|Код подтверждения: 001234STATUS_WAIT_CODESTATUS_CANCEL- Формат на порака: време-код-код-текст.Много пораки се одделени од колона.
- Текстот SMS самиот може да содржи колони и вертикални ленти. за надеждна паркинг, користење getSmsFull.
GETgetServicesУслуги+
Достапни услуги кодови. Одговорот е ограничен на површината на API клучот.
Директор
Објавување…
| Име | Кодекс на услугите service |
|---|
Дијалогот за услуги се споделува низ целиот добавувач. бројот на достапност се проверува одделно.
Можете да го ограничите клучот на одредени услуги, земји и провајдери. празни листи овозможуваат сите достапни опции.
Параметри
| Параметри | Типот | Опис |
|---|---|---|
api_key* | string | Личен API клуч на корисникот. |
country | integer | Земи ID од getCountries. |
* Потребен параметар. во сите барања исто така продава акција =getServices.
Пример за барање
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))
}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);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Земји+
Идентификување, имиња и повикувачки кодови за земјите во избраниот канал.
Директор
Објавување…
| Име | Идентификација на земјата country |
|---|
Можете да го ограничите клучот на одредени услуги, земји и провајдери. празни листи овозможуваат сите достапни опции.
Параметри
| Параметри | Типот | Опис |
|---|---|---|
api_key* | string | Личен API клуч на корисникот. |
* Потребен параметар. во сите барања исто така продава акција =getCountries.
Пример за барање
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))
}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);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 '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))
}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);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 '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))
}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);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())Одговори
{
"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 '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))
}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);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 |
{
"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 '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))
}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);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 '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))
}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);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 | Сесијата или претходниот број не припаѓа на вашиот профил.Проверете го идентификацијата и клучот. |
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.
{
"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"
}
}
}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.
/api/v1/catalogУслуги и земји/api/v1/tariffsSMS награди на цена по земја/api/v1/offersЦени и награди/api/v1/servicesДиректор/api/v1/countriesДиректор/api/v1/operatorsДиректор/api/v1/availability?country=1Број на достапност/api/v1/activationsНова сесија/api/v1/activations/batch?ids=42,43Проверка на повеќе броеви/api/v1/activationsПоследните 200 сесии: опсег = историја, чекање или сè/api/v1/activations/{id}Седница и пораки/api/v1/activations/{id}/sms?after_id=0&limit=100Новиот SMS со курзор/api/v1/activations/{id}/retryЧекајќи за SMS/api/v1/activations/{id}/finishзавршување/api/v1/activations/{id}/cancelОтмени/api/v1/activations/repeatБрој на патувања/api/v1/keysAPI Кључ/api/v1/keysСоздајте ја клучот/api/v1/keys/{id}Промена на име или политика/api/v1/keys/{id}Отфрлање на клучот/api/v1/referralsРеферентниот код и добивките/api/v1/summaryБаланс и резиме/api/v1/balanceЗадржани средства/api/v1/ledgerПридобивка ЛЕДГЕР/api/v1/withdrawalsЗаплата на барања/api/v1/withdrawalsСоздавање на барање/api/v1/statisticsОпшта статистика/api/v1/earnings/holdsЗадржување на приходитеПримање само нови SMS
GET /api/v1/activations/42/sms?after_id=0&limit=100
Authorization: Bearer YOUR_API_KEY{
"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 Достапни се само за сопствениците.