Numeralar, mesajlar, qaytarlar, direktni app sizdan.
SMScash
API Dokumentacion
Yatimadi

API Dokumentacion

Numeralar, mesajlar, qaytarlar, direktni app sizdan.

Bir islanga başlar.

13 · API komandoREST + handler_api.phpJSON / plain text · Bearer

Bir API key sizda, bir numir sizda, 20 sekonda mesajlar üçün kontrol edin. SMS-i kodla qaytarda qodib.

REST APIhttps://smscash.org/api/v1
Kompatibilni API bazal URLhttps://smscash.org/stubs/handler_api.php
Xizmat yaxshiTelefon raqamlari, SMS Mavjud boʻladi. USDT boʻyicha TRC20. Moslamalar orasida oʻrnatildi 1 va 45 kun.
REST / cURL – Xasib qurtlar
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}'

Alternatif uyumayan interfesi adres: /handler_api.php. REST integrasyonlar bilan bilan bilan bilan.

REST API

Soʻrov tuzuvchi

cURL · Go · JS · Python

Idempotency-Key: UUID · POST · 8–128

Avtomatik tanlash: oxirgi soatda, keyin 24 soatda eng ko‘p kod. Raqam yo‘q bo‘lsa, keyingi operator.

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

Kalit saqlanmaydi. Bu tekshiruv raqam bermaydi.

Yeni integrasyonlar üçün

Xizmatlar va mamlakatlar

Bir servis və bir ülke seç. SMS-ga payat bilan bilan bilan.

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)

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

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

Avtomatik tanlash: oxirgi soatda, keyin 24 soatda eng ko‘p kod. Raqam yo‘q bo‘lsa, keyingi operator.

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

Raqam 20 daqiqa uchun haqiqiy emas. SMS 20 soniya orasidagi tekshirildi. Butunlay bekor qilishingiz mumkin.

Bir nechta raqamni tekshirish
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
Balans · Ushlab turilgan
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 — Mavjud; held_balance — Ushlab turilgan. USD · 8

Faqat ushlab turish muddati tugagan mablag‘ni yechish mumkin.

Tayyor mijoz dasturlari

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 · Kompatibilni API bazal URLhttps://smscash.org/sms-activate/stubs/handler_api.php
HeroSMS · Kompatibilni API bazal URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Foydalanuvchining shaxsiy API kaliti.

Bir servis və bir ülke seç. SMS-ga payat bilan bilan bilan.

KodTadiq
getNumber / getNumberV2Bir numirga
getStatus / getStatusV2U‘ziyda koodlar
setStatus / finishActivation / cancelActivationSesi bilan
getPrices / getNumbersStatusTadiqlar bilan bilan bilan
getRewards (SMScash)SMS-dan qaytadi
getServicesList / getServicesXizmatlar
getCountries / getOperatorsXizmatlar va mamlakatlar
getActiveActivationsSesi
getBalanceFoydalanuvchi balansi
getHoldBalance (SMScash)Ushlab turilgan

cost = 0 USD · activationCost = 0 USD
reward — SMS-dan qaytadi

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

Raqam 20 daqiqa uchun haqiqiy emas. SMS 20 soniya orasidagi tekshirildi. Butunlay bekor qilishingiz mumkin.

Authentication və retries

REST: Tadiq Authorization: Bearer YOUR_API_KEY. Kompatiblik interfac: Parametri api_key va actionHTTPS qizizga.

API key'lar qadi, hesabinizdir.

∞Yatlar/minda bilan bilan bilan
∞Simultanga sesyonlar

API-dan qurtlar frekanslar, telefon numirlar saylar qurtlar. Günlük ya qurtlar yok.

Raqam 20 daqiqa uchun haqiqiy emas. SMS 20 soniya orasidagi tekshirildi. Butunlay bekor qilishingiz mumkin.

Bir o‘z, bir o‘z Idempotency-Key Numeralar bilan, qaytarda bilan, retry and payut demand. Bu seçkin, ama handler_api.php'da rekomandir. Network request'u retrying koʻyadi key. New key'u yeni bir operasyon için kullan.

API key gap

Boʻsh roʻyxatlarning barcha mavjud parametrlarini kerak boʻlishi mumkin.

JSON
{
  "label": "Software‘m",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} U'qizga, ismi və politikadi qaytadi.Sahdi yalnız yaratilgan.

10% total. 5% + 5% software kod.

Raqam boʻlganda, iltimos koʻrsating ref Dastur egasi. Talab qilishda xatolik roʻy berdi. Kod "Terferals" boʻyicha va bunda GET /api/v1/referrals → software_ref.

YatamaTadiqSoftware
Refa‘mga10%—
Ref bilan5%5%
Ref bilan hech qanday emas—5%

Platform bonusni ushbu qilishda qilib moslash. Dastur egasi va referer bir xil odam bo'lishi mumkin. Foydalanuvchining oʻz kodidan foydalanib bo'lmaydi.

Seans yaratilganda shartlar oʻrnatiladi SMS va retry Ularni oʻzgartirish yoʻq. ref Yangi seans uchun qaytadan yuklash. Tarif hisoblashda foydalanuvchi moslamasi USD 0.003 Qidirish USD 0.00015 har bir dastur egasi va referer. Jami bonus USD 0.00030.

API komando

11 XVBC-style metodlar plus siz SMScash bilan.

GETgetNumberBir numirga

Seansni yaratish va ishga tushirish uchun mavjud raqamlarni saqlab qolish. Moslama va tahrirlash qiymatini tahril qilishda oʻrnatilgan. SMS Kod bilan keladi.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.
service*stringMavjud xizmat kodlari. Javob API kalitining maydoniga cheksiz.
country*integerQidirish ID Kimdan getCountries.
operatorstringQidirish ID Kimdan operators/getOperators (API). operator=1 · any/0
session_durationintegerSesi 20 min. 20 min. o‘zayga bu parametrini kayga.
with_operatorinteger1 javobga operator ID sini qo‘shadi; 0 yoki parametr berilmasa, uchta qism qaytariladi.
refstringDastur egasinining odamli kodi: 5% va 5% u uchun davom emas. Davlat qilish uchun ref - 10%siz.

* Parametri va‘z. Bütün isilimlarda da aksiya=getNumber pass.

Muallif soʻrov

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'

Reagib

Numeradi bilan
ACCESS_NUMBER:42:380670000000:1
No number qozga
EMPTY_POOL
  • Avtomatik tanlash: oxirgi soatda, keyin 24 soatda eng ko‘p kod. Raqam yo‘q bo‘lsa, keyingi operator.
  • Yoʻq Idempotency-Key: shunday soʻrov oldingi seansni qayta qiladi. Parametrlarni oʻzgartirish IDEMPOTENCY_CONFLICT.
  • Bir pool olmadan numeral bir zemni EMPTY_POOL, bad country format is BAD_COUNTRY.
  • Oʻchirilgan seans kalitda qoʻllanilmaydi: shu tugma bilan tahrirlashni qaytadan oʻynash, SESION_CLOSED'dan foydalanish va boshqa raqam boʻlmaydi.
  • Tahrirlash natijasi tasdiqlanmagan. Ikkining raqamni tahrirlanmasin uchun avtomatik qaytadan keraklashni oʻchirib boʻladi.
GETgetNumbersStatusTadiqlar bilan bilan bilan

Xizmat va maʼlumot boʻyicha mavjud telefon raqami.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.
country*integerQidirish ID Kimdan getCountries.

* Parametri va‘z. Bütün isilimlarda da aksiya=getNumbersStatus pass.

Muallif soʻrov

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86'

Reagib

Tadiqlar
{
  "go_0": 0
}
  • _0 suffix o‘zari bir seçim o‘zari bir operator.
  • Mavjud boʻlgan faylning umumiy oʻlchamiga koʻrsatiladi. Tanlangan kanal raqam berilganda tekshirildi.
GETgetStatusU‘ziyda koodlar

Sesi statusni və son SMS kodni qaytadi. kodda qizizizlar kaygan.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.
id*integerSeansning ID'si, raqam kiritilganda olib tashlangan.

* Parametri va‘z. Bütün isilimlarda da aksiya=getStatus pass.

Muallif soʻrov

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42'

Reagib

Tadiq
STATUS_WAIT_CODE
Koodga qaytadi
STATUS_OK:001234
Cancellation o yasaqlar
STATUS_CANCEL
U‘zadi
NO_ACTIVATION
  • Har 20 soniya koʻrsatiladi. Xabarni qayta oʻqish boshqa moslama yaratilmagan.
  • Retrikdan sonra eski kod qaytarmay: getStatus bir sonraki SMS'i qaytarmaygan.
  • SMS orqali raqam oʻchirilmagandan keyin, getStatus va getSmss STATUS_CANCEL qaytadan qayta; getSmsFull yopish holati, boʻsh telefon va bosh sms roʻyxatini qayta qiladi. REST /activations/{id} va /smss 404 NO_ACTIVATION' ga qaytarish.
GETsetStatusSesi bilan

U'qiz, xiyim o'qiz, SMS'i qaytarga.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.
id*integerSeansning ID'si, raqam kiritilganda olib tashlangan.
status*integer3 - Seansni bajarishdan keyingi kodni kutib koʻrish; 6 - SMS; 8 - butunlay bekor qilish.

* Parametri va‘z. Bütün isilimlarda da aksiya=setStatus pass.

Muallif soʻrov

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'

Reagib

SMS'i qaytadi
ACCESS_RETRY_GET
Tadiq
ACCESS_ACTIVATION
Yatlamad
ACCESS_CANCEL
  • Keyingi kodni asl 20 daqiqada urinib koʻrish. Muddati va oʻchirish vaqti oʻzgartirilmaydi.
  • Comment3 ishlatiladigan Idempotency-Key: talabni takrorlash, allaqachon olib tashlangan yangi kodni qayta tiklash. SMS mavjud emas.
  • Bekor qilish allaqachon oʻchirilmagan moslamalarni olib tashlash.
  • SMS kodlu number qotʻlar kayan. kodlu olmayan kayanlar kayanlar kayanlar.
GETgetRepeatNumberBitta raqamni bosib chiqarish

Siz istoriyadan bir numaradan yeni bir sesyon qotlar. Siz bir başka servis seçib.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.
number*stringSizga eski numir. Yal numirlar və seçkin bir lider + qothatlar.
service*stringMavjud xizmat kodlari. Javob API kalitining maydoniga cheksiz.
session_durationintegerSesi 20 min. 20 min. o‘zayga bu parametrini kayga.
with_operatorinteger1 javobga operator ID sini qo‘shadi; 0 yoki parametr berilmasa, uchta qism qaytariladi.
refstringDastur egasinining odamli kodi: 5% va 5% u uchun davom emas. Davlat qilish uchun ref - 10%siz.
operatorstringQidirish ID Kimdan operators/getOperators (API). operator=1 · any/0

* Parametri va‘z. Bütün isilimlarda da aksiya=getRepeatNumber pass.

Muallif soʻrov

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'

Reagib

Yeni seansat
ACCESS_NUMBER:43:380670000000
Numeriyizga qurtlarga qurtlarga
NUMBER_IN_USE
  • Birincisi, sizga qurtlan o‘ziz. Sizga numir bo‘ziz, re-exuansi ko‘ziz.
  • Yeni sezyon o‘zayni yeni ID o‘zayni. eski SMS o‘zayni ko‘zayni. ref o‘zayni.
  • SMScash bu hesabın tarihini yalnız numirlar qaytarmadi.
  • Oʻchirilgan seans kalitda qoʻllanilmaydi: shu tugma bilan tahrirlashni qaytadan oʻynash, SESION_CLOSED'dan foydalanish va boshqa raqam boʻlmaydi.
GETgetSmsFullJSON sifatida SMSni olish

Bütün mesajlar ID, sendir, kod, tekst, land, servis, ve supplier data ile kayan bilan.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.
id*integerSeansning ID'si, raqam kiritilganda olib tashlangan.

* Parametri va‘z. Bütün isilimlarda da aksiya=getSmsFull pass.

Muallif soʻrov

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42'

Reagib

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"
}
  • Birlashtirish uchun koʻrsatilgan formati. sms[].id'ni faqat yangi xabarlarni koʻrsatish uchun eslab qolish.
  • Raqamli holat SMScash: 1 - aktiv, 6 - bajarildi. 8 - bekor qilindi yoki muddati oʻchirildi. status_name Kutilmoqda, olib tashlangan, tugadi, bekor qilindi, muddati oʻtish.
  • Seans yopishdan soʻng mavjud boʻlmaydi. Katta disk qismlar uchun REST /activations/{id}/sms'dan after_id bilan foydalaning.
  • SMS orqali raqam oʻchirilmagandan keyin, getStatus va getSmss STATUS_CANCEL qaytadan qayta; getSmsFull yopish holati, boʻsh telefon va bosh sms roʻyxatini qayta qiladi. REST /activations/{id} va /smss 404 NO_ACTIVATION' ga qaytarish.
GETgetSmsSMS bir texta string kimi qaytadi

Mavjud klientlar uchun qator formatida butun SMS tarixini qaytadan qayta qiladi.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.
id*integerSeansning ID'si, raqam kiritilganda olib tashlangan.

* Parametri va‘z. Bütün isilimlarda da aksiya=getSms pass.

Muallif soʻrov

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42'

Reagib

Messadi
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234
Tadiq
STATUS_WAIT_CODE
Cancellation o yasaqlar
STATUS_CANCEL
  • Xabarning koʻrinishi:
  • SMS-i özni kolonlar və vertikal barlar qo‘yadi. güvenilir parsing, getSmsFull'u kullan.
GETgetServicesXizmatlar

Mavjud xizmat kodlari. Javob API kalitining maydoniga cheksiz.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.
countryintegerQidirish ID Kimdan getCountries.

* Parametri va‘z. Bütün isilimlarda da aksiya=getServices pass.

Muallif soʻrov

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY'

Reagib

Xizmatlar
{
  "go": {
    "name": "Google",
    "code": "go"
  }
}
  • Servisdi direktori isshadi isshadi. Number disponibility is checked separat.
GETgetCountriesMamlakatlar

IDs, nomlar, calling codes qiya'lar seçkin kanalda.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.

* Parametri va‘z. Bütün isilimlarda da aksiya=getCountries pass.

Muallif soʻrov

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY'

Reagib

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

Mavjud operatorlar: API ID, nomi va mukofotni ushlab turish muddati.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.
countryintegerQidirish ID Kimdan getCountries.
operatorstringQidirish ID Kimdan operators/getOperators (API). operator=1 · any/0

* Parametri va‘z. Bütün isilimlarda da aksiya=getOperators pass.

Muallif soʻrov

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY'

Reagib

Operatorlar
{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}
  • Qidirish ID Kimdan operators/getOperators (API).
GETgetRewardsSMS-dan qaytadi

Jadvalning qiymati boʻlishi mumkin. Hamma qiymatlar moslamadi SMS.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.
countryintegerQidirish ID Kimdan getCountries.
servicestringMavjud xizmat kodlari. Javob API kalitining maydoniga cheksiz.
operatorstringQidirish ID Kimdan operators/getOperators (API). operator=1 · any/0

* Parametri va‘z. Bütün isilimlarda da aksiya=getRewards pass.

Muallif soʻrov

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi'

Reagib

JSON
{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}
{}
{}
  • USD tariff bilan bilan bilan bilan 8 decimal qotlarga xiyimlik bir decimal qotlarga qaytarga:
  • Kalitga yoqilgan providerlar mavjud.
  • country ID → service code → operator ID → reward (USD)
GETgetBalanceFoydalanuvchi balansi

Qoʻshimcha SMScash: mavjud balanchasini hisoblash, boshqaruvlar va moslamalar soʻroviga oʻtish.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.

* Parametri va‘z. Bütün isilimlarda da aksiya=getBalance pass.

Muallif soʻrov

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY'

Reagib

Balans
ACCESS_BALANCE:0.00
  • getBalance mavjud USD balansasini 8 oʻnlik boʻyiga koʻrsatadi.
  • Faqat ushlab turish muddati tugagan mablag‘ni yechish mumkin.
GETgetHoldBalanceUshlab turilgan

SMS olinganidan keyin daromad yetkazib beruvchi belgilagan muddatga ushlab turiladi. Belgilangan sanada summa avtomatik ravishda yechish uchun mavjud bo‘ladi.

Parametri

ParametrikTipTadiq
api_key*stringFoydalanuvchining shaxsiy API kaliti.

* Parametri va‘z. Bütün isilimlarda da aksiya=getHoldBalance pass.

Muallif soʻrov

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY'

Reagib

Ushlab turilgan
ACCESS_HOLD_BALANCE:34.50000001
  • SMScash · getHoldBalance · USD · 8
  • Faqat ushlab turish muddati tugagan mablag‘ni yechish mumkin.

Reply kodlar və tekrarlarlar

handler_api.php biznes natijasida oddiy HTTP 200 bilan boʻladi. Burcha matnni tekshiring. Direktoriyalar va getSmsFull return JSON agar muvaffaqiyat boʻlsa, xatolar har doim matn boʻlishi mumkin.

KodHTTPBir sonraki yadi
TARIFF_NOT_CONFIGURED200Davom emasRaqamni tahrirlash bir bitta SMS moslamalarini moslash mumkin.
COUNTRY_BLOCKED200@ info: whatsthisBir başka zemni seçin.
BAD_SERVICE200Bu servisin numblar bloklar.Di‘zari bir servis seçib.
PROVIDER_NOT_READY200Raqamni tahrirlash vaqtinchalik mavjud emasAPI kataloglarini yangilash.
BAD_KEY400Yoʻq api_key yoki xato format.Talab uchun kalitni tekshirish.
INVALID_API_KEY401Key is unknown, rebound o‘qont is disabled.Bir API key qadi.
BAD_COUNTRY400Manzil yoki muhim raqam yoʻq.Qidirish ID Kimdan getCountries.
BAD_SESSION_DURATION400Telefon numirlar 20 dakikadan qotʻlar.Taʼrifi session_duration.
BAD_REQUEST400Xato parametr Idempotency-Key.Sizga isilini koruyun.
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER200Unknown o disabled directory item.API kataloglarini yangilash.
BAD_NUMBER200Raqamning notoʻgʻri formati.Siz numirni digitlarda qo‘z.
BAD_ACTION / BAD_STATUS200Unnan, ID o operasyon.Parametrlarni tekshirish.
EMPTY_POOL200Joriy telefon raqami mavjud emas.10-30 sekni sonra tekrarlar o‘ziz o‘ziz filtrarlar.
NUMBER_IN_USE200Bir aktiv seanssiya bir numir o‘zizib.Seansni tugatish yoki boshqa raqamni tanlang.
NO_ACTIVATION200Sesi ya o‘zari number sizga hesabda olmaygan.ID və key bilan bilan bilan bilan.
SESSION_CLOSED / SMS_REQUIRED200Holat uzatish joriy mavjud emas.SMS'nin qotlamadini və qotlamadini kontrol.
SCOPE_BLOCKED200Service, country, o vendlar bu key için yetkilimiz olmaygan.API key'nin yasanni yasanni.
IDEMPOTENCY_CONFLICT200Ushbu soʻrov kaliti boshqa parametrlar bilan bogʻliq boʻlgan.Yeni bir operasyonda, bir başka Idempotency-Key-i yaratlar.
BAD_REF / SELF_REF400Dastur kodi nomaʼlum, oʻchirilgan yoki foydalanuvchi oʻziga emas.Suxo‘lar programın sahibinin kodlar.
INTERNAL_ERROR500Server o vendor error.Kechikish va bir xil qidirish Idempotency-Key.
ALLOCATION_PENDING200Raqamni tahrirlash allaqachon mavjud. Bir xil bilan qaytadan urinish Idempotency-Key.Raqamni tahrirlash allaqachon mavjud. Bir xil bilan qaytadan urinish Idempotency-Key.
ALLOCATION_UNCERTAIN200Tahrirlash natijasi tasdiqlanmagan. Ikkining raqamni tahrirlanmasin uchun avtomatik qaytadan keraklashni oʻchirib boʻladi.Tahrirlash natijasi tasdiqlanmagan. Ikkining raqamni tahrirlanmasin uchun avtomatik qaytadan keraklashni oʻchirib boʻladi.

REST bir objekti qaytarga {"error":{"code":"…","message":"…"}} va doim HTTP holati 400/401/403/404/409/503.

JSON
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Talab qilish maydonlarini tekshirish.",
    "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.

Yeni integrasyonlar üçün

USD tariff bilan bilan bilan bilan 8 decimal qotlarga xiyimlik bir decimal qotlarga qaytarga: 0.00300000 USD.

Balansa pul USD. Talab qilish va javob qoliplari mavjud emas OpenAPI.

USDT · TRC20'da qaytadiTo‘lovlar 1 kundan 45 kungacha davom etadi. Pul yechish komissiyasi 4 $. U so‘ralgan summadan ushlab qolinadi. SMS olinganidan keyin daromad yetkazib beruvchi belgilagan muddatga ushlab turiladi. Belgilangan sanada summa avtomatik ravishda yechish uchun mavjud bo‘ladi. Faqat ushlab turish muddati tugagan mablag‘ni yechish mumkin.
GET/api/v1/catalogXizmatlar va mamlakatlar
GET/api/v1/tariffsSMS Raqamlar
GET/api/v1/offersTariflar və premi
GET/api/v1/servicesDirektor
GET/api/v1/countriesDirektor
GET/api/v1/operatorsDirektor
GET/api/v1/availability?country=1Tadiqlarda disponibility
POST/api/v1/activationsYeni seansat
GET/api/v1/activations/batch?ids=42,43Bir nechta raqamni tekshirish
GET/api/v1/activationsSon 200 seats: scope=history, o‘qot o‘qot o‘qot
GET/api/v1/activations/{id}Sesiya və mesajlar
GET/api/v1/activations/{id}/sms?after_id=0&limit=100SMS qizizizga qizizizga
POST/api/v1/activations/{id}/retrySMS'i qaytadi
POST/api/v1/activations/{id}/finishTadiq
POST/api/v1/activations/{id}/cancelYatmadi
POST/api/v1/activations/repeatNumerari qaytar
GET/api/v1/keysAPI Key
POST/api/v1/keysBir key ko‘zadi
PATCH/api/v1/keys/{id}Nominadi ya politikan.
DELETE/api/v1/keys/{id}Key qiziziz
GET/api/v1/referralsReferral kodlar və qaytarlar
GET/api/v1/summaryName
GET/api/v1/balanceUshlab turilgan
GET/api/v1/ledgerLeddari bilan
GET/api/v1/withdrawalsPaytlarga qaytarga
POST/api/v1/withdrawalsBir islanni
GET/api/v1/statisticsStatistika bilan
GET/api/v1/earnings/holdsDaromadni ushlab turish

Yeni SMS'i qaytadi

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": "Kood: 001234",
      "sender": "Service",
      "received_at": "2026-10-09T12:00:00Z"
    }
  ],
  "next_cursor": 101,
  "has_more": false
}

Saqlash next_cursor Uni boshlab qoʻyish after_id. Agar has_more=trueKeyingi sahifa butunlay oʻqish mumkin. limit: 1–200. Seans va SMS faqat egasi uchun mavjud.