Farawa

Takardun API

Littattafai da saƙo da ciki, daga ainihin aiki.

GET

Fara da roƙo ɗaya

13 · 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 20. 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.

Farawa mai sauƙi · 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}'

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

REST API

Mai gina buƙatu

cURL · Go · JS · Python

TambayaAiki APIƙasa APIMai Aiki operatorRef na mulkin mazaɓen mazaɓaIdempotency-Key

Idempotency-Key: UUID · POST · 8–128

Zaɓi ta atomatik: mafi yawan lambobin tabbatarwa a sa’ar da ta wuce, sannan sa’o’i 24. Babu lambobin waya: mai ba da sabis na gaba.

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.

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

REST

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

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

Zaɓi ta atomatik: mafi yawan lambobin tabbatarwa a sa’ar da ta wuce, sannan sa’o’i 24. Babu lambobin waya: mai ba da sabis na gaba.

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

Yawan nan yana da inganci na miniti 20. An gabatar da SMS kowace sakan 20. 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": 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

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';
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 · 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' \
  -H 'Idempotency-Key: request-unique-001'

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); 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.

Yawan nan yana da inganci na miniti 20. An gabatar da SMS kowace sakan 20. 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 20. Za ka iya kashe nan da nan.

A GABA, musamman ne Idempotency-Key ana bukatar wajen ba da amfani da ladabi, maimaita waɗannan tarayya, ka sake jarraba kuma ka yi biyayya. Yana da amfanin abubuwa amma yana da aka ƙarfafa cikin handler_api.php. Sake amfani maɓallin idan kana sake sake yin riƙo wata roƙo mai tsari; ka yi amfanida wani sabuwar maɓalli don wata sabuwa aikin aiki.

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	Ka ɗauki shaidar daga operators/getOperators (API). `operator=1 · 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	Doden jama’a na makiyaci mazaɓen shawara: 5% Dõminsa, da shi. 5% "Dõmin mai kira, bã zã ta kasance ba." ref - 10% zuwa ga mai kira.

* 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' \
  -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)

Amsa

Lambar da aka gabatar da

ACCESS_NUMBER:42:380670000000:1

Babu alƙaluman da aka naɗa

EMPTY_POOL

Zaɓi ta atomatik: mafi yawan lambobin tabbatarwa a sa’ar da ta wuce, sannan sa’o’i 24. Babu lambobin waya: mai ba da sabis na gaba.
Shiga Idempotency-Key: wannan roƙon da maɓalli ɗaya na mai da zaman shawarar da ta gaba. Canje kira IDEMPOTENCY_CONFLICT.
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' \
  -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)

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.
Domin yanayi=3 amfani da Idempotency-Key: maimaita roƙon ba zai sake sake da sabon layin da aka riga aka karɓi ba. Tarihi na SMS za a iya samu.
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	Doden jama’a na makiyaci mazaɓen shawara: 5% Dõminsa, da shi. 5% "Dõmin mai kira, bã zã ta kasance ba." ref - 10% zuwa ga mai kira.
`operator`	string	Ka ɗauki shaidar daga operators/getOperators (API). `operator=1 · 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' \
  -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)

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

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.

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	Ka ɗauki shaidar daga operators/getOperators (API). `operator=1 · 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": "Оператор 1",
    "earnings_hold_days": 45
  }
}

Ka ɗauki shaidar daga operators/getOperators (API).

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	Ka ɗauki shaidar daga operators/getOperators (API). `operator=1 · 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)

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	Parameter mai maras inganci ko Idempotency-Key.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.
`IDEMPOTENCY_CONFLICT`	200	Wannan maɓallin tambaya an riga an haɗa da wasu shiryoyin bayani.Don wata sabuwar aiki, ƙiƙiro wata Idempotency-Key.
`BAD_REF / SELF_REF`	400	Babu sani ba, babu kashe, ko kuma na mai amfani kansa ba ne.Ka yi bayani a kan kwamfyutan mulkin shawarar.
`INTERNAL_ERROR`	500	Sava na ɗan lokaci ko kuskure mai sayewa.Maimaita da jinkiri da daidai. Idempotency-Key.
`ALLOCATION_PENDING`	200	An riga an ci gaba da raba wajen ladabi. Ka sake jarraba da ɗaya Idempotency-Key.An riga an ci gaba da raba wajen ladabi. Ka sake jarraba da ɗaya Idempotency-Key.
`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.