Започваме

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 и оттегляне не ги променят. Преминаване 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 и не издава друг номер.

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": "Оператор 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.

параметри

параметри	Типът	описание
`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	Сесията или предишният номер не принадлежи на Вашия акаунт.Проверете ID и ключ.
`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=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 са достъпни само за собственикът.