Takardun API

GET

Fara da roƙo ɗaya

14 · Umarni na APIREST + handler_api.phpJSON / plain text · Bearer

Ka ƙiƙiro wani maɓallin API cikin dashboard-ka, ka karɓi wata yawan dabam kuma ka kula wa sakan kowace sakan 10. An ɗauki biya idan wani SMS da wani layi ya zo; karanta shi ba zai shafi daidai da ka ba.

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

Daidaitawa API Tsari URLhttps://smscash.org/stubs/handler_api.php

Hidima tana rayuwaLambar tashar, SMS Kuma akwai abin da aka ciyar, kuma an sanya abin da ya sani. USDT zuwa TRC20. Sakamako ne suka ɗauki tsakaninsu. 1 Da 45 kwanaki.

Roƙo na misali · cURL

curl --get 'https://smscash.org/stubs/handler_api.php' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'action=getNumber' \
  --data-urlencode 'service=go' \
  --data-urlencode 'country=86'

Adireshin da aka dace da shi: /handler_api.php. Na ci gaba da yin aiki.

API

Mai gina buƙatu

cURL · Go · JS · Python

Daidaitawa API Tsari URLhttps://smscash.org/stubs/handler_api.php

Tambaya actionAiki serviceƙasa countryMai Aiki operatorShaidar Mai ba da, na bambanci koma: operator=1,3. Zaɓi ta atomatik: mai samarwa da ake samu bisa bazata.session_durationZaman shawarar na ambata minitocin 20. Na shigar da 20 ko kuma na bar wannan parametar.with_operator1 yana ƙara ID na mai gudanarwa a amsa; 0 ko rashin sigar yana dawo da ɓangarori uku.Ref na mulkin mazaɓen mazaɓa ref

cURL

curl --max-time 15 --fail-with-body 'https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1'

package main

import (
  "fmt"
  "io"
  "net/http"
  "net/url"
  "os"
  "time"
)

func main() {
  endpoint, err := url.Parse("https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1")
  if err != nil { panic(err) }
  query := endpoint.Query()
  query.Set("api_key", os.Getenv("SMSCASH_API_KEY"))
  endpoint.RawQuery = query.Encode()
  req, err := http.NewRequest("GET", endpoint.String(), nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second, CheckRedirect: func(_ *http.Request, _ []*http.Request) error { return http.ErrUseLastResponse }}
  res, err := client.Do(req)
  if err != nil { panic(err) }
  defer res.Body.Close()
  body, err := io.ReadAll(res.Body)
  if err != nil { panic(err) }
  fmt.Println(res.StatusCode, string(body))
}

JavaScript

// Node.js 18+: set SMSCASH_API_KEY in your environment.
const url = new URL("https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1");
url.searchParams.set("api_key", process.env.SMSCASH_API_KEY);
const response = await fetch(url, {
  method: 'GET',
  signal: AbortSignal.timeout(15000),
  redirect: 'error',
});
const result = await response.text();
console.log(response.status, result);
// SMS codes are strings: keep leading zeros. Never repeat issuance automatically.

Python

import json
import os
import urllib.error
import urllib.parse
import urllib.request

class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

url = "https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1"
parts = urllib.parse.urlsplit(url)
params = dict(urllib.parse.parse_qsl(parts.query))
params["api_key"] = os.environ["SMSCASH_API_KEY"]
url = urllib.parse.urlunsplit(parts._replace(query=urllib.parse.urlencode(params)))
request = urllib.request.Request(url, method='GET')
try:
    with urllib.request.build_opener(NoRedirect).open(request, timeout=15) as response:
        result = response.read().decode("utf-8")
        print(response.status, result)
except urllib.error.HTTPError as error:
    print(error.code, error.read().decode('utf-8'))
    raise
# No automatic retries; SMS codes remain strings.

Maɓallin API

Ba a adana maɓallin. Wannan dubawa ba ta bayar da lambobi.

MASU TSARKI don sabuwar haɗin kai

Ayyuka da ƙasashe

Zaɓi hidima da ƙasa. Bida kowace SMS na dangana daga ƙasar.

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)

Ka sami lambar

handler_api.php

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

Zaɓi ta atomatik: mai samarwa da ake samu bisa bazata.

REST

ACCESS_NUMBER: session ID · phone number
service + country · session_duration: 20
ref: software owner code (optional)
operator: public ID (e.g. 1) or comma-separated IDs (e.g. "1,3")
optional · omitted/any/0: random eligible provider
country: integer · service: string · SMS code: string

Yawan nan yana da inganci na miniti 20. An gabatar da SMS kowace sakan 10. Za ka iya kashe nan da nan.

Duba lambobi da yawa

REST

GET /api/v1/activations/batch?ids=42,43
Authorization: Bearer YOUR_API_KEY

JSON

{
  "rows": [
    {
      "id": 42,
      "found": true,
      "phone": "12025550123",
      "status": "received",
      "service": "go",
      "country_id": 86,
      "provider_id": 1,
      "operator": 1,
      "expires_at": "2026-10-10T12:15:00Z",
      "sms_count": 1,
      "code": "001234",
      "last_sms": {
        "id": 101,
        "code": "001234",
        "sender": "Service",
        "text": "Code: 001234",
        "received_at": "2026-10-10T12:01:00Z"
      }
    },
    {
      "id": 43,
      "found": false,
      "error": {
        "code": "NO_ACTIVATION",
        "message": "Session not found."
      }
    }
  ],
  "as_of": "2026-10-10T12:01:00Z",
  "poll_interval_seconds": 10
}

REST

ids: 1–100 positive session IDs, separated by commas
Input order preserved · duplicates removed
Foreign, unavailable or out-of-scope IDs: found=false
Read only · no supplier requests · last_sms is the latest message

Kuɗin asusu · Kuɗin da aka riƙe

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 — Akwai; held_balance — Kuɗin da aka riƙe. USD · 8

Za a iya cire kuɗi ne kawai bayan lokacin riƙewa ya ƙare.

Shirye-shiryen abokin ciniki masu shiri

JavaScript / Node.js ↓Python ↓

JavaScript · Node.js 18+

import {SmScash, SmScashError} from './smscash.mjs';

const api = new SmScash(process.env.SMSCASH_API_KEY);
const catalog = await api.catalog({service: 'go', country: 86});
console.log(catalog.rows);

const messages = await api.sms(42, {afterId: 0});
console.log(messages.sms);
const statuses = await api.batch([42]);
const held = await api.holdBalance();
console.log(held); // Exact USD string

Python 3.9+

import os
from smscash import SmScash, SmScashError

api = SmScash(os.environ['SMSCASH_API_KEY'])
catalog = api.catalog(service='go', country=86)
print(catalog['rows'])

messages = api.sms(42, after_id=0)
print(messages['sms'])
statuses = api.batch([42])
held = api.hold_balance()
print(held) # Exact USD string

SDK

me() · balance() · holdBalance()/hold_balance() · catalog() · activation() · sms() · batch()
setStatus(id, "cancel") / set_status(id, "cancel")
Timeout: 15 s · no dependencies · no automatic retries
Error: code · status · hint · requestId/request_id · retryable
ALLOCATION_UNCERTAIN: contact support with request_id; never retry automatically.

SMS-Activate / HeroSMS

SMS-Activate · Daidaitawa API Tsari URLhttps://smscash.org/sms-activate/stubs/handler_api.php

HeroSMS · Daidaitawa API Tsari URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Keɓaɓɓen maɓallin API na mai amfani.

Zaɓi hidima da ƙasa. Bida kowace SMS na dangana daga ƙasar.

Kod	Kwamfyuta
`getNumber / getNumberV2`	Ka sami lambar
`getStatus / getStatusV2`	Ka sami kwanan wata
`setStatus / finishActivation / cancelActivation`	Zaman Shawara
`getPrices / getNumbersStatus`	Ka kula da nasara
`getRewards (SMScash)`	Sakamakon SMS
`getServicesList / getServices`	Sabis
`getCountries / getOperators`	Ayyuka da ƙasashe
`getActiveActivations`	Zaman Shawara
`getBalance`	Ma’aunin mai amfani
`getHoldBalance (SMScash)`	Kuɗin da aka riƙe

cost = 0 USD · activationCost = 0 USD
reward — Sakamakon 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'

Amsa

{
  "activationId": "42",
  "phoneNumber": "393331234567",
  "activationCost": 0,
  "currency": 840,
  "countryCode": 86,
  "canGetAnotherSms": true,
  "activationTime": "2026-10-11T12:00:00Z",
  "activationEndTime": "2026-10-11T12:15:00Z",
  "reward": "0.00300000"
}

SMS-Activate / HeroSMS

GET or POST application/x-www-form-urlencoded
api_key · action · service · country · ref (optional)
setStatus: 1 → ACCESS_READY · 3 → ACCESS_RETRY_GET
           6 → ACCESS_ACTIVATION · 8 → ACCESS_CANCEL
getStatus: STATUS_WAIT_CODE · STATUS_OK:001234 · STATUS_CANCEL
getStatusV2: {"verificationType":1,"sms":null,"call":null}
getServicesList: {"status":"success","services":[{"code":"go","name":"Google"}]}
getCountries: {"86":{"id":86,"eng":"Italy","visible":1,"retry":1,"rent":0}}
getPrices: {"86":{"go":{"cost":0,"count":12,"reward":"0.00300000","currency":"USD"}}}
getRewards: {"59":{"vi":{"1":"0.01000000"}}}
getRewards filters: country · service · operator (optional, e.g. 1,3); any/0: all permitted providers
getActiveActivations: start=0 · limit=1–100 · activeActivations / data
Business/key errors: HTTP 200 + plain text · server errors: HTTP 500
Availability: actual supplier pool, shared cache up to 20 s; not a reservation
No automatic retries after a transport error or ALLOCATION_UNCERTAIN.
Unsupported: rent · calls · forwarding · multiple services per number · prolong
Unsupported options return BAD_REQUEST; unsupported actions return BAD_ACTION.
SMScash keys and country/service codes; configure this base URL in your software.

Yawan nan yana da inganci na miniti 20. An gabatar da SMS kowace sakan 10. Za ka iya kashe nan da nan.

Tabbaci da kuma Sake sake

REST: kanun sama Authorization: Bearer YOUR_API_KEY. Inda aka Dace: Parameti api_key Da action. Yi amfani da HTTPS.

Don ka kula da maɓallun API, ka shigar da sakinka.

∞roƙo/maƙila ko wani juna

∞Zaman shawara na ɗaya

API na roƙo mai sauƙi da yawan lambaran telefon ba su da iyaka ba. Babu kwatanci na kullum ko sa’a.

Yawan nan yana da inganci na miniti 20. An gabatar da SMS kowace sakan 10. Za ka iya kashe nan da nan.

Shirin maɓallin API

Za ka iya kawar da maɓallin hidimomi, ƙasashe da kuma mai - sadaukarwa na musamman.

JSON

{
  "label": "Shiryoyin aiki na",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} ana canja sunan da tsari gabaki ɗaya. An nuna ɓoye kawai sa’ad da aka halitta.

10% gabaki ɗaya. 5% + 5% da kodin kwamfyutan shawara.

Sa'ad da aka gabatar da wata alƙalu, ku ba da bayani ref mai amfanin shiri na shiryoyin shawarar. Maɓallin mai tsiri ya ba da amfani da roƙon. Layin na cikin sashe na "Saurarar" da kuma cikin GET /api/v1/referrals → software_ref.

Tambaya	Ƙayi da	Masarrafin Kwamfyuta
Ba tare da rayuwa ba	10%	—
Da ref	5%	5%
Abin sani kawai, babu wata al'amari.	—	5%

Platform na bayar da bonus ba tare da rage kuɗin aiki ba. Makiyayi na matsayin shawara da mai magana zai iya zama mutum ɗaya. Mai amfani ba zai iya amfani da nasu ba.

An ƙayyade ƙa’idodin da aka halitta wani zaman shawara; karatu SMS Da retry Kada ka musanya su. ref Sa'an nan kuma wata sabuwar zaman shawara maimaitawa. USD 0.003 ba da USD 0.00015 kowace zuwa makiyakin shawara da kuma ƙwarai. Gaba gaɗin bonus ce USD 0.00030.

Umarni na API

Hanyoyin salon XVBC 11 da daidai da SMScash-ka.

GETgetNumberKa sami lambar

Yana halitta wani zaman shawara kuma ya zaɓi lada da aka samu wa mai amfani. An tsai da yawan sadaukarwa da kuma sadaukar da aka ɗauke; an ɗauka sakamakon idan wani SMS mai ladabi ya zo.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`service`*	string	Kodin aikin da aka samu. Amsar tana kawai zuwa wurin maɓallin API.
`country`*	integer	Ka ɗauki shaidar daga getCountries.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`
`session_duration`	integer	Zaman shawarar na ambata minitocin 20. Na shigar da 20 ko kuma na bar wannan parametar.
`with_operator`	integer	1 yana ƙara ID na mai gudanarwa a amsa; 0 ko rashin sigar yana dawo da ɓangarori uku.
`ref`	string	Публичный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getNumber.

Roƙo na misali

curl

curl 'https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1",
    timeout=15,
)
print(response.status_code, response.text)

Amsa

Lambar da aka gabatar da

ACCESS_NUMBER:42:380670000000:1

Babu alƙaluman da aka naɗa

EMPTY_POOL

Zaɓi ta atomatik: mai samarwa da ake samu bisa bazata.
Wata ƙasa dabam da ba tare da pool na ba da EMPTY_POOL; tsarin ƙasa mai kyau shine BAD_COUNTRY.
An ci gaba da amfani da maɓallin zaman shawarar da aka goge: sake karanta rabon da wannan maɓalli mai dawowa SESION_CLOSED kuma ba ya bada wani alƙaluman ba.
Ba a tabbatar da sakamakon da aka samu ba. An kasa sake ƙoƙari farat ɗaya don a guji ware alƙaluman na biyu.

GETgetNumbersStatusKa kula da nasara

An sami lamburi na tarho ta wajen hidima da ƙasar.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`country`*	integer	Ka ɗauki shaidar daga getCountries.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getNumbersStatus.

Roƙo na misali

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

Amsa

Sura da aka samu

{
  "go_0": 0
}

Sififiyar _0 na nuni zaɓi ba tare da wani operat na musamman ba.
Za a iya samun abin da yake nuni game da shi. An gane hanyar da aka zaɓi idan an ba da wasu yawa.

GETgetStatusKa sami kwanan wata

Roƙo mai sauƙi wa yanayin zaman shawara da kuma kwamfyutan SMS na ƙarshe. An riƙe shirin ƙunyoyi cikin layin.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`id`*	integer	Shaidar zaman shawararka, da aka karɓi sa’ad da aka gabatar da yawan.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getStatus.

Roƙo na misali

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)

Amsa

Yana Jiran

STATUS_WAIT_CODE

An karɓi kod

STATUS_OK:001234

An kashe ko ciki

STATUS_CANCEL

Ba'a gano ba

NO_ACTIVATION

Ka ɗauke kowace sakan 20. Sake karanta saƙo ba ya halicci wani kuɗi ba.
Bayan an sake sake tsohon ladar ba: getStatus na jiran SMS na gaba.
Bayan wasu dabam ba tare ba SMS an goge getStatus Da getSms mai da STATUS_CANCEL; getSmsFull mai da halin rufe, mai maras komai da mai marasa komai sms jerin. REST /activations/{id} Da /sms mai da 404 NO_ACTIVATION.

GETsetStatusZaman Shawara

Yana gama, ya kashe ko kuma ya ci gaba da jira zuwa SMS. Zaman shawarar na cika daidai.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`id`*	integer	Shaidar zaman shawararka, da aka karɓi sa’ad da aka gabatar da yawan.
`status`*	integer	3 — ka jira ladar na gaba ba tare da yawa; 6 — ka gama bayan SMS; 8 — ka goge nan da nan.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=setStatus.

Roƙo na misali

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=setStatus&api_key=YOUR_API_KEY&id=42&status=3",
    timeout=15,
)
print(response.status_code, response.text)

Amsa

Jiran SMS

ACCESS_RETRY_GET

Cikakken Cika

ACCESS_ACTIVATION

An kashe

ACCESS_CANCEL

Ka sake jira na gaba a cikin miniti 20 na farko.
Cirewa ba ta cire sakamako da aka samu ba.
Lambar kawai da ɗaya SMS An keɓe layi cikin tarihin. An kashe lamburi da aka ƙara ƙarshe ba tare da layi ba.

GETgetRepeatNumberSake ba da lambar ɗaya

Za ka iya zaɓi wani hidimar da aka samu a ƙasar ɗaya.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`number`*	string	Lambar tsohonku. An ƙyale su kawai alƙaluman da wata ɗabi'a na ɗaukaka +.
`service`*	string	Kodin aikin da aka samu. Amsar tana kawai zuwa wurin maɓallin API.
`session_duration`	integer	Zaman shawarar na ambata minitocin 20. Na shigar da 20 ko kuma na bar wannan parametar.
`with_operator`	integer	1 yana ƙara ID na mai gudanarwa a amsa; 0 ko rashin sigar yana dawo da ɓangarori uku.
`ref`	string	Публичный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getRepeatNumber.

Roƙo na misali

curl

curl 'https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go'

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go");
const result = await response.text();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getRepeatNumber&api_key=YOUR_API_KEY&number=380670000000&service=go",
    timeout=15,
)
print(response.status_code, response.text)

Amsa

Sabuwar zaman shawara

ACCESS_NUMBER:43:380670000000

Yawancin har yanzu yana aiki

NUMBER_IN_USE

Da farko, ka kashe ko ka ka daina zaman shawarar ka yanzu. Idan yawan nan yawa na ƙoƙari, ba za'a sake zartar da ba.
Sabon zaman shawarar ya karɓi sabon shaidar da tafashi na yanzu. Ba a buɗe tsohon SMS cikinsa ba. An sake daidaita ref.
SMScash na yarda kawai maimaita alƙaluman daga tarihin wannan labarin.
An ci gaba da amfani da maɓallin zaman shawarar da aka goge: sake karanta rabon da wannan maɓalli mai dawowa SESION_CLOSED kuma ba ya bada wani alƙaluman ba.

GETgetSmsFullKa Sami SMS Yadda JSON

An halitta tarihin duk saƙo da shaida, mai gabatar da, kodi, rubutu da ƙasa, bayani na hidima da kuma mai sadaukarwa.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`id`*	integer	Shaidar zaman shawararka, da aka karɓi sa’ad da aka gabatar da yawan.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getSmsFull.

Roƙo na misali

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

Amsa

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

Tsari na son haɗin kai. Ka tuna sms[].id kawai ya aikata sabon saƙo.
Halin lafiya SMScash: 1 - ƙwazo. 6 gamawa, 8 - an kashe ko kuma an gama. status_name an rarraba tsakanin jira, an karɓi, an gama, an kashe, an rage.
An ci gaba da samun kodin da aka karɓi bayan da wani zaman shawara ta rufe. Don girma, ka yi amfani da shi REST /activations/{id}/sms tare da after_id.
Bayan wasu dabam ba tare ba SMS an goge getStatus Da getSms mai da STATUS_CANCEL; getSmsFull mai da halin rufe, mai maras komai da mai marasa komai sms jerin. REST /activations/{id} Da /sms mai da 404 NO_ACTIVATION.

GETgetSmsKa sami SMS kamar jimlar rubutu

Ba da duk tarihin SMS cikin tsarin jimlar wa masu kilayant da ke nan.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`id`*	integer	Shaidar zaman shawararka, da aka karɓi sa’ad da aka gabatar da yawan.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getSms.

Roƙo na misali

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)

Amsa

Saƙo

STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234

Yana Jiran

STATUS_WAIT_CODE

An kashe ko ciki

STATUS_CANCEL

Tsari na saƙo: horaʹcodeʹtext. An raba saƙon dabam dabarun saƙyoyin da aka bambanta.
Rubutun SMS Zai iya ƙunshi ƙoƙari masu ɗaukaka da kuma ƙwayoyi masu tsaye. Domin yin magana da aka tabbaci, ka yi amfani da shi getSmsFull.

GETgetServicesSabis

Kodin aikin da aka samu. Amsar tana kawai zuwa wurin maɓallin API.

Gafakan

Bugawa…

JSON ↗

An raba gafakan hidimar a dukan mai amfani da shi. An gabatar da samun labuwa dabam.

Za ka iya kawar da maɓallin hidimomi, ƙasashe da kuma mai - sadaukarwa na musamman.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`country`	integer	Ka ɗauki shaidar daga getCountries.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getServices.

Roƙo na misali

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

Amsa

Sabis

{
  "go": {
    "name": "Google",
    "code": "go"
  }
}

An raba gafakan hidimar a dukan mai amfani da shi. An gabatar da samun labuwa dabam.

GETgetCountriesƘasashe

Shaidar, sunaye da kuma kiran kodin wa ƙasashen da aka zaɓi.

Gafakan

Bugawa…

JSON ↗

Za ka iya kawar da maɓallin hidimomi, ƙasashe da kuma mai - sadaukarwa na musamman.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getCountries.

Roƙo na misali

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

Amsa

Ƙasashe

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

GETgetOperatorsMai Aiki

Masu aiki da ake da su: ID na API, suna da lokacin riƙe lada.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`country`	integer	Ka ɗauki shaidar daga getCountries.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getOperators.

Roƙo na misali

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

Amsa

Mai Aiki

{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "operator=1",
    "earnings_hold_days": 45
  }
}

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

GETgetRewardsSakamakon SMS

Kayan da aka dangana da ƙasar. Dukan kwamfyutan tebur suna da SMS da aka biya.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`country`	integer	Ka ɗauki shaidar daga getCountries.
`service`	string	Kodin aikin da aka samu. Amsar tana kawai zuwa wurin maɓallin API.
`operator`	string	Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. `operator=1 · operator=1,3 · any/0`

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getRewards.

Roƙo na misali

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

Amsa

JSON

{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}

{}

{}

An mai da waɗannan kwamfyutan taƙaitawa na USD mai daidai da wurare masu shekara 8:
Maba'arka na samu mai samun ƙarfi.
country ID → service code → operator ID → reward (USD)

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

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

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.
`service`*	string	Код сервиса из getServices.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getTopCountriesByService.

Roƙo na misali

curl

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

package main

import (
  "fmt"
  "io"
  "net/http"
  "time"
)

func main() {
  req, err := http.NewRequest("GET", "https://smscash.org/stubs/handler_api.php?action=getTopCountriesByService&api_key=YOUR_API_KEY&service=go", nil)
  if err != nil { panic(err) }
  client := &http.Client{Timeout: 15 * time.Second}
  resp, err := client.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  body, err := io.ReadAll(resp.Body)
  if err != nil { panic(err) }
  fmt.Println(resp.StatusCode, string(body))
}

javascript

const response = await fetch("https://smscash.org/stubs/handler_api.php?action=getTopCountriesByService&api_key=YOUR_API_KEY&service=go");
const result = await response.json();
console.log(response.status, result);

python

import requests

response = requests.get(
    "https://smscash.org/stubs/handler_api.php?action=getTopCountriesByService&api_key=YOUR_API_KEY&service=go",
    timeout=15,
)
print(response.status_code, response.json())

Amsa

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

Ключ в примере	Kwamfyuta	Gafakan
`["12"], ["36"]`	Shaidar ƙasa Первый, внешний уровень JSON. Каждая запись объединяет операторов одной страны.	`getCountries`
`["12"]["1"], ["12"]["3"]`	ID оператора Второй уровень JSON, внутри страны. Это публичный ID оператора (поставщика), который передаётся в параметре operator.	`getOperators`

JSON

{
  "12": {
    "1": {
      "reward": 0.012,
      "count": 542
    },
    "3": {
      "reward": 0.014,
      "count": 301
    }
  },
  "36": {
    "1": {
      "reward": 0.011,
      "count": 190
    }
  }
}

{}

{}

В примере ["12"]["1"] — данные оператора 1 в стране 12. ID стран берутся из getCountries, ID операторов — из getOperators.
reward — действующее личное вознаграждение в USD, JSON-число. count — количество выданных номеров за последние 24 часа, включая сессии без кода.
Рейтинг рассчитывается как все полученные непустые коды, делённые на все выдачи номеров за последние 24 часа для выбранного сервиса.
Повторные непустые коды увеличивают числитель; конверсия может превышать 100%. Начальные нули сохраняются.
Суточная статистика сервиса кэшируется на 10 минут. Тарифы и ограничения ключа проверяются при каждом запросе. Момент среза — в заголовке X-Statistics-As-Of.
Нет данных или доступных связок — пустой объект {}. Страны с выдачами и нулём кодов имеют нулевую конверсию. Порядок ключей JSON не задаёт места в рейтинге.

GETgetBalanceMa’aunin mai amfani

Ƙari ga SMScash: da za a iya yin daidai da ɗauke da ƙoƙari mai da hankali, tsofaffi da roƙon biyayya.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getBalance.

Roƙo na misali

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)

Amsa

Kuɗin asusu

ACCESS_BALANCE:0.00

getBalance na mai da da kwance na USD da kusan wurare 8.
Za a iya cire kuɗi ne kawai bayan lokacin riƙewa ya ƙare.

GETgetHoldBalanceKuɗin da aka riƙe

Bayan an karɓi SMS, ana riƙe kuɗin shiga na tsawon lokacin da mai samarwa ya kayyade. A ranar da aka kayyade, kuɗin zai kasance a shirye don cirewa kai tsaye.

Annabci na Farawa

Parameter	Na'ura	Kwamfyuta
`api_key`*	string	Keɓaɓɓen maɓallin API na mai amfani.

* Faramin na bukata. Cikin duk roƙo suna shiga aiki=getHoldBalance.

Roƙo na misali

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)

Amsa

Kuɗin da aka riƙe

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
Za a iya cire kuɗi ne kawai bayan lokacin riƙewa ya ƙare.

Kod da aka sake amsa da tambayoyi maimaitawa

Shiga handler_api.php sakamakon kasuwanci na sau da yawa suna tare da HTTP 200. Ka kalli rubutun jiki. Gafakan da kuma getSmsFull mai da JSON idan sun yi nasara; kurare na rubutu ne a kowane lokaci.

Kod	HTTP	Dalilin da kuma matafiya ta gaba
`TARIFF_NOT_CONFIGURED`	200	Ba a daidaita nishaɗi baZa'a fara wajen ba da ladabi sau da aka canzatar da SMS.
`COUNTRY_BLOCKED`	200	An kashe wajen ba da laburi wa wannan ƙasar.Ka zaɓi wani ƙasa.
`BAD_SERVICE`	200	An kawar da wajen ba da labuwa wa wannan hidimar.Ka zaɓi wata hidima.
`PROVIDER_NOT_READY`	200	Babu samun wajen ba da juna na kwance baKa sauƙaƙa takardar API.
`BAD_KEY`	400	Ao api_key ko tsari mai maras inganci.Ka kula da maɓallin cikin roƙon.
`INVALID_API_KEY`	401	Ba'a sani maɓallin ba, ba'a kawar da ko kuma an kashe linkin.Ka ƙiƙiro wani maɓallin API mai inganci.
`BAD_COUNTRY`	400	ƙasar tana rasa ko kuma ba ya daidai ba.Ka ɗauki shaidar daga getCountries.
`BAD_SESSION_DURATION`	400	An fitar da alƙaluman tarho na miniti 20.Daidaita session_duration.
`BAD_REQUEST`	400	Ka kula da gidan roƙon.Don Allah ka gyara roƙonka.
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Abun gafakan wanda ba'a sani ba ko ya kashe.Ka sauƙaƙa takardar API.
`BAD_NUMBER`	200	Tsarin lamba mai maras kyau.Ba da lambar cikin siffofi.
`BAD_ACTION / BAD_STATUS`	200	Umarni wanda ba'a sani ba, shaidar ko aiki.Ka kula da kayan daidaita.
`EMPTY_POOL`	200	Babu alƙaluman da ke daidaita na telefon a yanzu.Maimaita bayan sakan 10-30 ko kuma canja silla.
`NUMBER_IN_USE`	200	Akwai wasu dabam da aka ƙoƙari.Ƙarfafa zaman shawararka ko kuma zaɓi wani alƙaluman.
`NO_ACTIVATION`	200	Zaman shawarar ko yawan da aka gabatar ba ne na asirinka ba.Ka kalli shaidar da maɓalli.
`SESSION_CLOSED / SMS_REQUIRED`	200	Yanzu babu samun juyin ƙasar.Ka kula da yanayin da aka samu na SMS.
`SCOPE_BLOCKED`	200	Ba a ɗauki hidimar, ƙasar, ko kuma mai sayar da shi ba.Sake shirin faɗin maɓallin API.
`INTERNAL_ERROR`	500	Sava na ɗan lokaci ko kuskure mai sayewa.Tuntuɓa da taimako · X-Request-ID
`ALLOCATION_PENDING`	200	Yana JirangetActiveActivations · getStatus
`ALLOCATION_UNCERTAIN`	200	Ba a tabbatar da sakamakon da aka samu ba. An kasa sake ƙoƙari farat ɗaya don a guji ware alƙaluman na biyu.Ba a tabbatar da sakamakon da aka samu ba. An kasa sake ƙoƙari farat ɗaya don a guji ware alƙaluman na biyu.

REST mai da wani abu {"error":{"code":"…","message":"…"}} da kuma yanayin HTTP a kai ga 400/401/403/404/409/503.

JSON

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Ka kula da gidan roƙon.",
    "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.

MASU TSARKI don sabuwar haɗin kai

An mai da waɗannan kwamfyutan taƙaitawa na USD mai daidai da wurare masu shekara 8: 0.00300000 USD.

Kuɗin da kewaye shi ne USD. An sami roƙo da kuma amsa cikin OpenAPI.

Ka ɗauke da shi USDT · TRC20Biyan kuɗi yana ɗaukar kwanaki 1 zuwa 45. Cajin cire kuɗi shi ne 4 $. Ana cire shi daga adadin da aka nema. Bayan an karɓi SMS, ana riƙe kuɗin shiga na tsawon lokacin da mai samarwa ya kayyade. A ranar da aka kayyade, kuɗin zai kasance a shirye don cirewa kai tsaye. Za a iya cire kuɗi ne kawai bayan lokacin riƙewa ya ƙare.

GET/api/v1/catalogAyyuka da ƙasashe

GET/api/v1/tariffsJama'a na ladabi na SMS ga ƙasar

GET/api/v1/offersSakamako da sakamako

GET/api/v1/servicesGafakan

GET/api/v1/countriesGafakan

GET/api/v1/operatorsGafakan

GET/api/v1/availability?country=1Na samu yawan

POST/api/v1/activationsSabuwar zaman shawara

GET/api/v1/activations/batch?ids=42,43Duba lambobi da yawa

GET/api/v1/activationsZaman shawarar 200 na ƙarshe: scope=history, jira ko dukan

GET/api/v1/activations/{id}Zaman Shawara da Saƙo

GET/api/v1/activations/{id}/sms?after_id=0&limit=100Sabuwar SMS mai mazaɓa

POST/api/v1/activations/{id}/retryJiran SMS

POST/api/v1/activations/{id}/finishCikakken Cika

POST/api/v1/activations/{id}/cancelCire

POST/api/v1/activations/repeatSake sake fitar da Lambar

GET/api/v1/keysMaɓallun API

POST/api/v1/keysƘiƙiro wani maɓalli

PATCH/api/v1/keys/{id}Canza suna ko tsari

DELETE/api/v1/keys/{id}Kawar da maɓallin

GET/api/v1/referralsDokar magana da ciki

GET/api/v1/summaryDaidai da Ƙaƙa

GET/api/v1/balanceKuɗin da aka riƙe

GET/api/v1/ledgerƘari ga haka, ƙwazo

GET/api/v1/withdrawalsTambayoyin kirki

POST/api/v1/withdrawalsKa ƙiƙiro wani roƙo

GET/api/v1/statisticsTakardun Alkawari

GET/api/v1/earnings/holdsRiƙe kuɗin shiga

An karɓi sabuwar SMS kawai

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

Adana next_cursor Sa'an nan ku jẽfa ta, kamar yadda take. after_id. Dace has_more=true, za a iya karanta shafi na gaba nan da nan. ƙarshen: 1–200. Zaman Shawara da kuma SMS za a iya samu kawai ga maigidan.