Bishaarka

Dukumentiyada API

Lambaro, farriin iyo shaqo oo toos ah aqoonsigaada.

GET

Ka bilaaba hal codsiga

13 · Amarka APIREST + handler_api.phpJSON / plain text · Bearer

Sameeya furayaasha API ee dowladdaada, lambar ka heli ogolaanshaha 20 sekun oo dhan. Lacagta waxaa lagu aaminayaa markii uu SMS lacag la yimaado; ka akhriso mar kale ma saameyn miisaankaada.

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

URL aasaasiga ah ee APIhttps://smscash.org/stubs/handler_api.php

Adeegga waa noloshaLambaro telefoon, SMS Waxaana heli karaa waxyaabaha la soo bixiyo. USDT sameynta TRC20. Ijaarka dhexdooda waxaa la qaadaa 1 iyo 45 maalmood.

Bishaha degdegta ah · 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}'

Cinwaanka la xiriira la xidhiidha: /handler_api.php. La-qabsashada REST ee maalmeedka ah waxay shaqeeyaan.

REST API

Dhise codsiyada

cURL · Go · JS · Python

CodsigaAdeegga APIDalka APIShaqaalaha operatorLambarka sharciga ee shahaadadaIdempotency-Key

Idempotency-Key: UUID · POST · 8–128

Doorasho toos ah: koodhadhka ugu badan saacaddii u dambaysay, kadib 24 saacadood. Lambaro ma jiraan: bixiyaha xiga.

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.

Fursadaha API

Furaha lama kaydiyo. Hubintani ma qoondeyso lambarro.

MAAMIHinta la-qabsashada cusub

Adeegyada iyo dalalka

Doora adeegga iyo dalka. Lacagta SMS walba waxaad ka xiran tahay wadanka.

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)

Helitaan lambaro

REST

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

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

Doorasho toos ah: koodhadhka ugu badan saacaddii u dambaysay, kadib 24 saacadood. Lambaro ma jiraan: bixiyaha xiga.

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

Lambarkaadu waa shaqeynaya 20 saacadda. SMS waxaa la soo jeedaa 20 sekun oo dhan. Waxaad sii baxsan kartaa markiiba.

Hubi dhowr lambar

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

Haraaga · Lacag la hakiyey

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 — La heli karo; held_balance — Lacag la hakiyey. USD · 8

Waxaa lala bixi karaa oo keliya lacagta muddada hakinteedu dhammaatay.

Barnaamijyada macmiilka ee diyaarka ah

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 · URL aasaasiga ah ee APIhttps://smscash.org/sms-activate/stubs/handler_api.php

HeroSMS · URL aasaasiga ah ee APIhttps://smscash.org/hero-sms/stubs/handler_api.php

Furaha API ee gaarka ah ee isticmaalaha.

Doora adeegga iyo dalka. Lacagta SMS walba waxaad ka xiran tahay wadanka.

Kodka	Tilmaan
`getNumber / getNumberV2`	Helitaan lambaro
`getStatus / getStatusV2`	Helitaan codka ugu dambe
`setStatus / finishActivation / cancelActivation`	Wareegsashada sameynta
`getPrices / getNumbersStatus`	Imtixaan helitaanka
`getRewards (SMScash)`	Abaal maritaanka SMS
`getServicesList / getServices`	Adeegyada
`getCountries / getOperators`	Adeegyada iyo dalalka
`getActiveActivations`	Shirkadaha
`getBalance`	Hadhaaga isticmaalaha
`getHoldBalance (SMScash)`	Lacag la hakiyey

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

Jawaabta

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

Lambarkaadu waa shaqeynaya 20 saacadda. SMS waxaa la soo jeedaa 20 sekun oo dhan. Waxaad sii baxsan kartaa markiiba.

Aqoonsiga iyo dib u soo guurista

REST: qofkaas Authorization: Bearer YOUR_API_KEY. Xarunta la xiriira: parameeraad api_key iyo action. Isticmaal HTTPS.

Si aad furayaasha API ku wareegso, gala akoontaada.

∞codsashada/saacadaha xisaabta

∞sameynta islamarkaasna

Waqtiga codsashada API iyo lambarada telefoonku waa qiimayn. Ma jiro saacadaha ama saacadood.

Lambarkaadu waa shaqeynaya 20 saacadda. SMS waxaa la soo jeedaa 20 sekun oo dhan. Waxaad sii baxsan kartaa markiiba.

REST ka mid ah Idempotency-Key waa loo baahan yahay lambarka lambarada, lacagta lacageedka, la sii wareegsan, waxyaabaha la siibsada iyo bixiyaha. Waa la dooran, laakiin waxaa lagu talo gaarayaa handler_api.php. Isticmaaliya furayaasha marka aad codsaneyso codsiga shabakadda; isticmaala aqoon cusub shaqo cusub.

Shaqo API-bixinta

Waxaad ku xadgudbi kartaa adeegyada, wadamada iyo bixiyaha gaarka ah.

JSON

{
  "label": "Dalbaariyadayda",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} waxaa lagu beddelaa magaca iyo sayidka oo dhan, qarsoonka waxaa loo muuqdaa marka lagu abuuro.

10% oo dhamaan ah. 5% + 5% la xiriira shahaadada shirkadaha.

Marka aad lambar ka soo bixiso, waxaad bixisaa ref codsiga waxaa ogolaanshaha furayaasha isticmaalayaasha. Sharcigu wuxuu ku jira qaybta "Waqtiga lacagta" iyo qofka GET /api/v1/referrals → software_ref.

Codsiga	Dibadda	Talobixinta
La’aantiis	10%	—
Isla xiriir	5%	5%
Ref ma jiro	—	5%

Jaamacadda waxaa bixiya boonaska la'aan la'aanta isticmaalayaasha. Shaqada iyo shahaadada waxey isku mid noqon karaan. Shaqo-isticmaalayaasha ma isticmaali karo lacagtooda.

Sharciga waxaa la dhigaa marka lagu abuuro shirkad; akhriso SMS iyo retry Ha badalin, kana badalina. ref mar kale ururka cusub ee lagu soo celiyo. USD 0.003 bixiya USD 0.00015 Dhammaan waxaa loogu talagalay qof kasta oo ay lahaayeen shahaadada shirkadaha iyo waxbarashada. USD 0.00030.

Amarka API

11 XVBCdhaqdhaqaaqada sameynta SMScash Miisaanka.

GETgetNumberHelitaan lambaro

Shaqada isticmaalayaasha lambarka helitaanka waxaa loo qeybqaabiyaa isticmaale. Tirada abaalmarinta iyo qaadashada diiwaangelinta waxaa lagu qeybinayaa; mushaarku waa la aasaaray markii ay shaqadu tahay SMS lacag la yimaado.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.
`service`*	string	Lambarka adeegga ee la xiriira. Jawabku wuxuu ku xiran yahay aasaasiga API.
`country`*	integer	Ka qaada cayimanka getCountries.
`operator`	string	Ka qaada cayimanka operators/getOperators (API). `operator=1 · any/0`
`session_duration`	integer	Januunku wuxuu joogay 20 daqii ah. Wax 20 ama parameetinku ka tag.
`with_operator`	integer	1 wuxuu jawaabta ku daraa ID-ga hawlwadeenka; 0 ama haddii aan la sheegin wuxuu soo celiyaa saddex qaybood.
`ref`	string	Lambarka dadweynaha ee ilkaha shirkadaha: 5% iyo isaga. 5% u yeedhiyaasha la'aan. ref - 10% Ee wax u yeedhi.

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getNumber.

Codsiga tusaale

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)

Jawaabta

Lambar la soo bixiyey

ACCESS_NUMBER:42:380670000000:1

Lambaro ma jiro

EMPTY_POOL

Doorasho toos ah: koodhadhka ugu badan saacaddii u dambaysay, kadib 24 saacadood. Lambaro ma jiraan: bixiyaha xiga.
Wakhtiga Idempotency-Key: isku codsashada isla mid ah oo isku mid ah ayaa soo celinaya sameynta hore. IDEMPOTENCY_CONFLICT.
Wadamada lacagta la’aanta la'aanta waxaa bixiya EMPTY_POOL, foomka xun ee dalka waa BAD_COUNTRY.
Furiinka shirkadda la xiriira waa la isticmaalaa: islamarkaasna la xidhiidha lacagta la siiyo SESION_CLOSEd, lambarka kalena ma bixin.
Lacagta lacagtuhu ma xaqiijinayo. Imtixaanka waqtiga ah waxaa naafada ah si aadan lambarka labaad u bixin.

GETgetNumbersStatusImtixaan helitaanka

Lambaro telefoon ah oo ku hela adeegga iyo dalka.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.
`country`*	integer	Ka qaada cayimanka getCountries.

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getNumbersStatus.

Codsiga tusaale

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

Jawaabta

Lambaro la leeyahay

{
  "go_0": 0
}

Kuwarshada _0 waa doorashada la’aan shaqaalaha gaarka ah.
Lacagta la xiriira waxaa loola jeedaa boolka guud ee bixiyaha. Xanaanka la doortay waxaa la jeedi karaa marka lambaro la qeybo.

GETgetStatusHelitaan codka ugu dambe

Codsashada fudud ee xirfadaha sameynta iyo lambarka SMS ee ugu dambaysa. Kooxda loogu talogalay waxaa lagu xadgudbiyaa.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.
`id`*	integer	Aqoonsiga sameyntaada, markii lambarka la soo dejiyo.

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getStatus.

Codsiga tusaale

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)

Jawaabta

Sugta

STATUS_WAIT_CODE

Lambarka la helay

STATUS_OK:001234

Lacagta ama dhamaadka

STATUS_CANCEL

Ma helin

NO_ACTIVATION

Daboolka 20 sekun oo dhan. Aqriga wargelinku mar kale ma uu abuuro mushaar kale.
Ka dib lacagta hore laguma soo celin: getStatus wuxuu sugaa SMS-ga soo dambeeyay.
Lambaro la’aan ka dib SMS waa la furan yahay getStatus iyo getSms dib u celinta STATUS_CANCEL; getSmsFull ku soo celinaya xaaladaha xiriirka, telefoonka fog iyo madhan sms liiska. REST /activations/{id} iyo /sms dib u celinta 404 NO_ACTIVATION.

GETsetStatusWareegsashada sameynta

Waxyaabaha lagu dhamaado, lacagta ama la sameeyo sugaha SMS. Shahaadku wuxuu si isku mid ah yahay.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.
`id`*	integer	Aqoonsiga sameyntaada, markii lambarka la soo dejiyo.
`status`*	integer	3 — sug lacagta soo dambe la’aan sii badbaadaneyn; 6 — dhamaada dabadeed SMS; 8 — ka laaba markiiba.

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=setStatus.

Codsiga tusaale

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)

Jawaabta

Sugta SMS

ACCESS_RETRY_GET

Dhamaystay

ACCESS_ACTIVATION

Dib u laabatay

ACCESS_CANCEL

Sii waqtiga lacagta soo bixiya 20 daqiiqa aasaasiga ah ugu sugi. Arrinta iyo wakhtiga dhamaadka ma beddelin.
Status=3 isticmaalka Idempotency-Key: warbixinta codsiga lama sameyn karo lacagta cusub ee uu horay helay. Taariikhda SMS ayaa jira.
Lacagta ma fasaxyo abaalmarinta dhammaantood.
Taariikhda lambaro lambarka lacagta SMS oo keliya waxaa lagu xadgudbi karaa. Lambaro lagu baxay oo lambar la’aan la’aanta la'aanta.

GETgetRepeatNumberLambarka isku sameynta

Waxaad ka dooran kartaa adeegga kale oo ka heli kartaa wadankaas.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.
`number`*	string	Lambarkaada hore waxaa loo ogolaanshahaa lambarada iyo lambaro lacagta loogu talagalay.
`service`*	string	Lambarka adeegga ee la xiriira. Jawabku wuxuu ku xiran yahay aasaasiga API.
`session_duration`	integer	Januunku wuxuu joogay 20 daqii ah. Wax 20 ama parameetinku ka tag.
`with_operator`	integer	1 wuxuu jawaabta ku daraa ID-ga hawlwadeenka; 0 ama haddii aan la sheegin wuxuu soo celiyaa saddex qaybood.
`ref`	string	Lambarka dadweynaha ee ilkaha shirkadaha: 5% iyo isaga. 5% u yeedhiyaasha la'aan. ref - 10% Ee wax u yeedhi.
`operator`	string	Ka qaada cayimanka operators/getOperators (API). `operator=1 · any/0`

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getRepeatNumber.

Codsiga tusaale

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)

Jawaabta

Ururka cusub

ACCESS_NUMBER:43:380670000000

Lambarka waa weli xiriir

NUMBER_IN_USE

Marka hore, dhamaada ama la laabashada shirkaddaada. Haddii lambarkaadu ay xidhiidhaa, lama samayn karo dib u noqon.
Ururka cusub wuxuu helaa aqoon cusub iyo taarifaha hadda. SMS-oogga hore looma qorayn karo. Ref waa la sameynayaa.
SMScash wuxuu ogolaanshahaa lambaro kaliya oo taariikhda akoonka. Wadanka waxaa laga aqoonsanayaa lambarka.
Furiinka shirkadda la xiriira waa la isticmaalaa: islamarkaasna la xidhiidha lacagta la siiyo SESION_CLOSEd, lambarka kalena ma bixin.

GETgetSmsFullHelitaanka SMS sidii JSON

Taariikhda wargelinta oo dhan ee la xiriira aqoonsiga, soo diray, koodka, qoraalka iyo wadanka, adeegga iyo bixiyaha.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.
`id`*	integer	Aqoonsiga sameyntaada, markii lambarka la soo dejiyo.

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getSmsFull.

Codsiga tusaale

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

Jawaabta

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

Furiinka la qabsashada la xiriira. Xusuusnow sms[].id si aad u qabsato wargelin cusub oo kaliya.
Xaaladaha lambarka SMScash: 1 - shaqeynaya, 6 - wada dhameynta, 8 - la siiyey ama la dhamaado. status_name kala bixiyaa sugaha dhexdooda, la helay, la dhamaado, la lacagtay, waana dhammaysan.
Sharciga la heli karo ka dib waxaa sii heli kara codsiga. REST /activations/{id}/sms iyo after_id.
Lambaro la’aan ka dib SMS waa la furan yahay getStatus iyo getSms dib u celinta STATUS_CANCEL; getSmsFull ku soo celinaya xaaladaha xiriirka, telefoonka fog iyo madhan sms liiska. REST /activations/{id} iyo /sms dib u celinta 404 NO_ACTIVATION.

GETgetSmsHelitaanka SMS sidii qorsheed

Taariikhda SMS oo dhan waxaa lagu soo celinayaa macaamiisha joogtada ah.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.
`id`*	integer	Aqoonsiga sameyntaada, markii lambarka la soo dejiyo.

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getSms.

Codsiga tusaale

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)

Jawaabta

Wargelinta

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

Sugta

STATUS_WAIT_CODE

Lacagta ama dhamaadka

STATUS_CANCEL

Foomka wargelinta: horaadkode ë text. Warar badan waxaa kala duwan kulul.
Aqoonsiga SMS isticmaali karaa xarunta aqoonsiga ah getSmsFull.

GETgetServicesAdeegyada

Lambarka adeegga ee la xiriira. Jawabku wuxuu ku xiran yahay aasaasiga API.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.
`country`	integer	Ka qaada cayimanka getCountries.

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getServices.

Codsiga tusaale

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

Jawaabta

Adeegyada

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

Kaarka adeegga waxaa lagu qeybqaabiyaa bixiyaha dhexdooda. Lambarada waxaa loo soo jeedaa kala duduwan.

GETgetCountriesDalalka

Aqoonsiga, magacyada iyo wacdiga wadamada ee caanada la doortay.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getCountries.

Codsiga tusaale

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

Jawaabta

Dalalka

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

GETgetOperatorsShaqaalaha

Hawl-wadeennada la heli karo: aqoonsiga API, magaca iyo muddada abaalmarinta la hayo.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.
`country`	integer	Ka qaada cayimanka getCountries.
`operator`	string	Ka qaada cayimanka operators/getOperators (API). `operator=1 · any/0`

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getOperators.

Codsiga tusaale

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

Jawaabta

Shaqaalaha

{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}

Ka qaada cayimanka operators/getOperators (API).

GETgetRewardsAbaal maritaanka SMS

Heerarka waxaa ku xiran wadanka. Lacagta miisada oo dhan waxaa lagu bixiyaa SMS.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.
`country`	integer	Ka qaada cayimanka getCountries.
`service`	string	Lambarka adeegga ee la xiriira. Jawabku wuxuu ku xiran yahay aasaasiga API.
`operator`	string	Ka qaada cayimanka operators/getOperators (API). `operator=1 · any/0`

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getRewards.

Codsiga tusaale

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

Jawaabta

JSON

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

{}

{}

Lacagta taarifa ee USD waxaa loogu soo celinayaa sida toban toban ah oo ah 8 meelaha tobanka:
Faahfaahinyadaada waxaa laga heli karaa.
country ID → service code → operator ID → reward (USD)

GETgetBalanceHadhaaga isticmaalaha

SMScash iskuul: Miisaanka la siiyo xisaabta sameynta, boonasyada diiwaangelinta iyo codsiga mushaarka.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getBalance.

Codsiga tusaale

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)

Jawaabta

Haraaga

ACCESS_BALANCE:0.00

getBalance wuxuu ku soo celinaa miisaanka USD la xiriira 8 meelaha tobanka.
Waxaa lala bixi karaa oo keliya lacagta muddada hakinteedu dhammaatay.

GETgetHoldBalanceLacag la hakiyey

Marka SMS la helo, dakhliga waa la hakiyaa muddada bixiyuhu dejiyey. Taariikhda la cayimay, lacagtu si toos ah ayey u diyaar noqotaa in lala baxo.

Parameeradaha

Parameer	Nooca	Tilmaan
`api_key`*	string	Furaha API ee gaarka ah ee isticmaalaha.

* Parameedka loogu baahan yahay. Codsashada oo dhan waxaa sidoo kale ku socda aqoonsiga=getHoldBalance.

Codsiga tusaale

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)

Jawaabta

Lacag la hakiyey

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
Waxaa lala bixi karaa oo keliya lacagta muddada hakinteedu dhammaatay.

Kooda jawaabta iyo codsashada la celinayo

Geli handler_api.fp waxyaabaha ganacsiga inta badan waxaa la soo gaaraa HTTP 200. Eegi qoraalka jidhka. getSmsFull dib u celinta JSON haddii ay gaaban tahay, haddii xadgudubku mar walba waa qoraal.

Kodka	HTTP	Sidoo kale iyo safarka soo dambe
`TARIFF_NOT_CONFIGURED`	200	Tirada weli ma sameynBixinta lambarada waxaa bilaabaya markii lagu sameysto abaalmarinta SMS.
`COUNTRY_BLOCKED`	200	Bixinta lambarada ee dalka waxaa la xiriiraa.Doorta dal kale.
`BAD_SERVICE`	200	Lambarada adeegga waxaa la xiriiraa.Doora adeeg kale.
`PROVIDER_NOT_READY`	200	Lambarada lacagta waxey ku meelgaar ah ma jiroCusboonaya calaamooyinka API.
`BAD_KEY`	400	Ma aha foomka api_key ama xumaanta.Eegi xiriirka codsiga.
`INVALID_API_KEY`	401	Fursadaha ma aqoonsato, waa la xiriira ama xisaabtu waa naafada.Sameeya furayaal API ee shaqeynaya.
`BAD_COUNTRY`	400	Wadanku waa la’aan ama lambar fiican.Ka qaada cayimanka getCountries.
`BAD_SESSION_DURATION`	400	Lambarada telefoonka waxaa lagu sameynayaa 20 daqii ah.Toosannaanta session_duration.
`BAD_REQUEST`	400	Parameerka shaqeynayadda ama Idempotency-Key.Codso codsigaada.
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Waxyaabaha aqoon ama naafada ah.Cusboonaya calaamooyinka API.
`BAD_NUMBER`	200	Foom lambar aan xaqa ahayn.Sii lambarka lambarada lacagta.
`BAD_ACTION / BAD_STATUS`	200	Amarka aqoonsashada ama hawlgabka.Imtixaana waxyaabaha.
`EMPTY_POOL`	200	Haatan lambaro telefoon ah ma jiro.Ku noqon 10-30 tiki ka dib ama isbedel silo.
`NUMBER_IN_USE`	200	Tirada gaarka ah waxaa lagu qabanqaabiyaa shuruudaha shaqada.Shirkadaada dhameyso ama dooran lambarka kale.
`NO_ACTIVATION`	200	Cunuggu ama lambarka hore ma aha akoonkaada.Imtixaan aqoon iyo furayaasha.
`SESSION_CLOSED / SMS_REQUIRED`	200	Waqtiga wadamada ma jiro.Eegi shuruudaha SMS iyo helitaanka.
`SCOPE_BLOCKED`	200	Adeegga, wadanka ama kireystaha laguma aqbalo fursadaha.Dalabka shabakadda API.
`IDEMPOTENCY_CONFLICT`	200	Furiinka codsigaas waa la xiriiraa parameeyo kale.Adeegsashada cusub Idempotency-Key.
`BAD_REF / SELF_REF`	400	Shahaadada daryeelka ah waa maqan, naafada ama waa isticmaalayaasha.Sharciga ehelka ee dalka shirkadaha.
`INTERNAL_ERROR`	500	Seerka ku meelgaar ah ama khasaarka iibka ah.Ku noqon isla dib iyo isku mid Idempotency-Key.
`ALLOCATION_PENDING`	200	Lambarka waxaa joogtaday. Si isku mid ah ku baxso Idempotency-Key.Lambarka waxaa joogtaday. Si isku mid ah ku baxso Idempotency-Key.
`ALLOCATION_UNCERTAIN`	200	Lacagta lacagtuhu ma xaqiijinayo. Imtixaanka waqtiga ah waxaa naafada ah si aadan lambarka labaad u bixin.Lacagta lacagtuhu ma xaqiijinayo. Imtixaanka waqtiga ah waxaa naafada ah si aadan lambarka labaad u bixin.

REST wuxuu soo celiyaa wax {"error":{"code":"…","message":"…"}} iyo shahaadada HTTP ee joogtada ah 400/401/403/404/409/503.

JSON

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Imtixaana duurka codsiga.",
    "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.

MAAMIHinta la-qabsashada cusub

Lacagta taarifa ee USD waxaa loogu soo celinayaa sida toban toban ah oo ah 8 meelaha tobanka: 0.00300000 USD.

Lacagta miisaanka waa USD. OpenAPI.

Guri USDT · TRC20Lacag-bixintu waxay qaadataa 1 ilaa 45 maalmood. Khidmadda lacag la bixidda waa 4 $. Waxaa laga jarayaa qadarka la codsaday. Marka SMS la helo, dakhliga waa la hakiyaa muddada bixiyuhu dejiyey. Taariikhda la cayimay, lacagtu si toos ah ayey u diyaar noqotaa in lala baxo. Waxaa lala bixi karaa oo keliya lacagta muddada hakinteedu dhammaatay.

GET/api/v1/catalogAdeegyada iyo dalalka

GET/api/v1/tariffsTirada mushaarka SMS ee wadanka ah

GET/api/v1/offersTirada iyo abaalmarinta

GET/api/v1/servicesDoog

GET/api/v1/countriesDoog

GET/api/v1/operatorsDoog

GET/api/v1/availability?country=1Lambarka la xiriira

POST/api/v1/activationsUrurka cusub

GET/api/v1/activations/batch?ids=42,43Hubi dhowr lambar

GET/api/v1/activations200 sare ee ugu dambaysay: appoint=history, suga ama dhammaan

GET/api/v1/activations/{id}Waxbarashada iyo wargelooyinka

GET/api/v1/activations/{id}/sms?after_id=0&limit=100SMS cusub ku jira cilmiga

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

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

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

POST/api/v1/activations/repeatLambar ku noqon

GET/api/v1/keysFursadaha API

POST/api/v1/keysAdeeg furiinka

PATCH/api/v1/keys/{id}Beddela magac ama sayidka

DELETE/api/v1/keys/{id}Fursadaha la soo bixiyo

GET/api/v1/referralsLambarka la xiriira iyo lacagta

GET/api/v1/summaryMiisaanka iyo xisaabadda

GET/api/v1/balanceLacag la hakiyey

GET/api/v1/ledgerWaxyaabaha dhaqaalaha

GET/api/v1/withdrawalsCodsiga bixinta

POST/api/v1/withdrawalsSameeya codsiga

GET/api/v1/statisticsTasbixinta guud

GET/api/v1/earnings/holdsHakinta dakhliga

Qaadashada SMS cusub oo kaliya

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

Sameynta next_cursor Kana tagsiiyana isagoo kale. after_id. haddii has_more=trueBogga soo bixinta waxaa la akhriyo markiiba. 1–200. Ururada iyo SMS waxaa laga heli karaa qofka leh oo keliya.