Kuanza kwa

Ufafanuzi wa API

Idadi, ujumbe na faida, moja kwa moja kutoka kwa app yako.

GET

Kuanzisha kwa maombi moja

13 · Msimamo wa APIREST + handler_api.phpJSON / plain text · Bearer

Kutoa kioo cha API kwenye dashboard yako, kupata idadi na kuangalia kwa ujumbe kila sekunde 20. Kazi inakabiliwa wakati SMS na code inakuja; kusoma tena haina athari ya kiwango chako.

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

Ushirikiano wa API msingi URLhttps://smscash.org/stubs/handler_api.php

Huduma ya kuishiIdadi ya simu, SMS na faida ni inapatikana. kuondoa ni inatumika katika USDT kwa TRC20Utaratibu unafanyika kati ya 1 na 45 ya siku.

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

Adresa ya interface ya mbadala: /handler_api.php. Inayo ya REST inafanya kazi.

REST API

Kijenzi cha maombi

cURL · Go · JS · Python

Maombi yaHuduma ya APINchi ya APIOperesheni operatorMsimamizi wa programu ya code refIdempotency-Key

Idempotency-Key: UUID · POST · 8–128

Uchaguzi wa moja kwa moja: misimbo mingi zaidi katika saa iliyopita, kisha saa 24. Hakuna nambari: mtoa huduma anayefuata.

cURL

curl --max-time 15 --fail-with-body -X POST 'https://smscash.org/api/v1/activations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: request-unique-001' \
  --data '{"service":"go","country":86}'

package main

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

func main() {
  payload := []byte("{\"service\":\"go\",\"country\":86}")
  req, err := http.NewRequest("POST", "https://smscash.org/api/v1/activations", bytes.NewReader(payload))
  if err != nil { panic(err) }
  req.Header.Set("Authorization", "Bearer " + os.Getenv("SMSCASH_API_KEY"))
  req.Header.Set("Content-Type", "application/json")
  req.Header.Set("Idempotency-Key", "request-unique-001")
  client := &http.Client{Timeout: 15 * time.Second, CheckRedirect: func(_ *http.Request, _ []*http.Request) error { return http.ErrUseLastResponse }}
  res, err := client.Do(req)
  if err != nil { panic(err) } // Keep the same operation key after a network error.
  defer res.Body.Close()
  body, err := io.ReadAll(res.Body)
  if err != nil { panic(err) }
  if res.StatusCode >= 300 {
    fmt.Fprintf(os.Stderr, "HTTP %d, request_id=%s\n%s\n", res.StatusCode, res.Header.Get("X-Request-ID"), body)
    os.Exit(1)
  }
  fmt.Println(string(body))
}

JavaScript

// Node.js 18+: set SMSCASH_API_KEY in your environment.
const response = await fetch("https://smscash.org/api/v1/activations", {
  method: "POST",
  headers: {
    Authorization: 'Bearer ' + process.env.SMSCASH_API_KEY,
    'Content-Type': 'application/json',
    'Idempotency-Key': "request-unique-001",
  },
  body: JSON.stringify({
  "service": "go",
  "country": 86
}),
  signal: AbortSignal.timeout(15000),
  redirect: 'error',
});
const result = await response.json();
if (!response.ok) {
  const error = result.error || {};
  console.error(response.status, error.code, error.hint, error.request_id);
  throw new Error(error.message || 'API error');
}
console.log(result);
// SMS codes are strings: keep leading zeros. Never retry writes automatically.

Python

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

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

headers = {
    'Authorization': 'Bearer ' + os.environ['SMSCASH_API_KEY'],
    'Content-Type': 'application/json',
    'Idempotency-Key': "request-unique-001",
}
request = urllib.request.Request(
    "https://smscash.org/api/v1/activations",
    headers=headers,
    data="{\"service\":\"go\",\"country\":86}".encode('utf-8'),
    method="POST",
)
try:
    with urllib.request.build_opener(NoRedirect).open(request, timeout=15) as response:
        result = json.load(response)
    print(result)
except urllib.error.HTTPError as error:
    details = json.load(error).get('error', {})
    print(error.code, details.get('code'), details.get('hint'), details.get('request_id'))
    raise
# No automatic retries; SMS codes remain strings.

API Nyuma ya

Ufunguo hauhifadhiwi. Ukaguzi huu hautoi nambari.

Mwisho wa ushirikiano mpya

Huduma na nchi

Usafiri wa huduma na nchi. Kazi kwa SMS inategemea nchi.

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)

Unaweza kupata idadi

REST

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

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

Uchaguzi wa moja kwa moja: misimbo mingi zaidi katika saa iliyopita, kisha saa 24. Hakuna nambari: mtoa huduma anayefuata.

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

Idadi ya SMS inapatikana kwa dakika 20 na inapatikana kila sekunde 20.

Kagua nambari kadhaa

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

Salio · Fedha zilizozuiliwa

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 — Inapatikana; held_balance — Fedha zilizozuiliwa. USD · 8

Fedha zinaweza kutolewa tu baada ya muda wa kuzizuia kuisha.

Programu za mteja zilizo tayari

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 · Ushirikiano wa API msingi URLhttps://smscash.org/sms-activate/stubs/handler_api.php

HeroSMS · Ushirikiano wa API msingi URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Ufunguo wa API wa mtumiaji.

Usafiri wa huduma na nchi. Kazi kwa SMS inategemea nchi.

Msimamo wa	Maelezo ya
`getNumber / getNumberV2`	Unaweza kupata idadi
`getStatus / getStatusV2`	Kufikia code ya hivi karibuni
`setStatus / finishActivation / cancelActivation`	Utawala wa Sisi
`getPrices / getNumbersStatus`	Utafiti wa Uwezekano
`getRewards (SMScash)`	Tuzo ya SMS
`getServicesList / getServices`	Huduma
`getCountries / getOperators`	Huduma na nchi
`getActiveActivations`	Mkutano
`getBalance`	Salio la mtumiaji
`getHoldBalance (SMScash)`	Fedha zilizozuiliwa

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

Maana ya

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

Idadi ya SMS inapatikana kwa dakika 20 na inapatikana kila sekunde 20.

Usalama na kuondoka

REST: Mtaalamu Authorization: Bearer YOUR_API_KEY. Ushirikiano wa kuunganisha: Mipango ya api_key na actionKuendesha HTTPS kwa ajili ya

Ili kuendesha nyenzo za API, tafadhali kuingia akaunti yako.

∞Maombi / dakika kwa akaunti

∞Mkutano wa wakati huo

Utafiti wa API na idadi ya simu ni bila kuhariri.Hakuna kodi ya kila siku au saa.

Idadi ya SMS inapatikana kwa dakika 20 na inapatikana kila sekunde 20.

Kwa upande mwingine, moja ya Idempotency-Key ni muhimu kwa ajili ya idadi ya usambazaji, usambazaji mara kwa mara, kuondoka na maombi ya malipo. ni ya kipekee lakini inawezekana katika handler_api.php. Kisha kutumia nyenzo wakati wa kuondoka mahitaji ya mtandao; kutumia nyenzo mpya kwa shughuli mpya.

Mzunguko wa API

Unaweza kuhifadhi nyenzo kwa huduma maalum, nchi na watumishi. orodha ya kutosha inawezesha chaguo zote zilizopo.

JSON

{
  "label": "Programu ya mimi",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} Kazi na jina la kubadilika kabisa. siri inakuja tu wakati wa kuumbwa.

10% kwa jumla. 5% + 5% na code ya programu.

Wakati wa kuwasilisha idadi, tafadhali kutoa ref Mtu wa programu. Maombi ni ya kuwasilishwa na nyenzo ya mtumiaji. Msimbo ni katika sehemu ya "Mathiri" na katika GET /api/v1/referrals → software_ref.

Maombi ya	Mkutano wa	Programu ya
Bila ya ref	10%	—
Kwa njia ya ref	5%	5%
Kwa njia ya ref, hakuna referrer	—	5%

Pata jukwaa la malipo bila kupunguza faida ya watumiaji.Miliki wa programu na mwalimu wa mawasiliano wanaweza kuwa mtu mmoja.Mwalimu hawezi kutumia code yao mwenyewe.

Siku zinapatikana wakati wa kuunda; kusoma SMS na kuondoka haina mabadiliko yao. Kuanzisha ref tena kwa ajili ya mkutano mpya wa kuongezeka. Katika uhitaji wa bei, mshahara wa watumiaji wa USD 0.003 hutoa USD 0.00015 kila kwa mteja wa programu na mwongozo. Bonus ya jumla ni USD 0.00030.

Msimamo wa API

11 njia ya XVBC-style plus usawa wako wa SMScash.

GETgetNumberUnaweza kupata idadi

Kuunda mkutano na kuhifadhi idadi inayotumika kwa watumiaji. kiwango cha mshahara na wateja wa maonyesho ni ya kutosha kwa ajili ya kuagiza; mshahara inahusishwa wakati SMS na code inakuja.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.
`service`*	string	Kodi za huduma zinazopatikana.Jibu ni ya chini ya eneo la kuki ya API.
`country`*	integer	Takeen ID ±a getCountries.
`operator`	string	Takeen ID ±a operators/getOperators (API). `operator=1 · any/0`
`session_duration`	integer	Mkutano huo una muda wa dakika 20. kufikia 20 au kuacha parameter hii.
`with_operator`	integer	1 huongeza ID ya opereta kwenye jibu; 0 au kutoweka kigezo hurudisha sehemu tatu.
`ref`	string	Kodi ya umma ya mteja wa programu: 5% kwa yeye na 5% kwa mteja. bila ref - 10% kwa mteja.

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getNumber.

Maombi ya mfano

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)

Maana ya

Idadi ya kuwasilishwa

ACCESS_NUMBER:42:380670000000:1

Hakuna idadi ya kufikia

EMPTY_POOL

Uchaguzi wa moja kwa moja: misimbo mingi zaidi katika saa iliyopita, kisha saa 24. Hakuna nambari: mtoa huduma anayefuata.
♫ Pass Idempotency-Keyʹ: the same request with theself key return the previous session. Change the parameters calls IDEMPOTENCY_CONFLICT.
Nchi ya idadi bila pool inatoa EMPTY_POOL; format ya nchi ya dhahabu ni BAD_COUNTRY.
Nyuma ya sesioni iliyotolewa bado inatumika: kurejesha upatikanaji na nyuma hiyo inatuma SESSION_CLOSED na haitatoa idadi nyingine.
Matokeo ya uagizo haikubalika. upungufu wa automatic ni haiwezekani kuepuka uagizo wa idadi ya pili.

GETgetNumbersStatusUtafiti wa Uwezekano

Idadi ya simu inapatikana kwa huduma na nchi.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.
`country`*	integer	Takeen ID ±a getCountries.

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getNumbersStatus.

Maombi ya mfano

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

Maana ya

Idadi ya kutumika

{
  "go_0": 0
}

_0 suffix inamaanisha uchaguzi bila mteja maalum.
Uwezekano unahusu pool ya jumla ya mtoa huduma. kanali iliyochaguliwa inahusishwa wakati idadi inachaguliwa.

GETgetStatusKufikia code ya hivi karibuni

Maombi rahisi ya hali ya sesini na code ya mwisho ya SMS. Zero ya juu katika code ni kuhifadhi.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.
`id`*	integer	ID ya mkutano wako, alikubali wakati idadi hiyo ilipitishwa.

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getStatus.

Maombi ya mfano

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)

Maana ya

kuangalia

STATUS_WAIT_CODE

Kodi ya kupokea

STATUS_OK:001234

Ulimwengu au kuhariri

STATUS_CANCEL

Hakuna kutafuta

NO_ACTIVATION

Pole kila mmoja 20 Kuandika ujumbe tena haina kuunda malipo mengine.
Baada ya kuondoka, code ya zamani haijawekwa: getStatus inatarajia kwa SMS ya pili.
Baada ya idadi ya watu bila SMS ya kuondolewa, getStatus na getSms Kutoa kwa STATUS_CANCEL; getSmsFull kurejesha hali ya kufungwa, simu ya kutosha na simu ya kutosha sms ya orodha. REST /activations/{id} na /sms Kutoa kwa 404 NO_ACTIVATION.

GETsetStatusUtawala wa Sisi

Kuja, kuondoka au kurejea kuangalia kwa SMS. Mkutano wa mwisho ni sawa.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.
`id`*	integer	ID ya mkutano wako, alikubali wakati idadi hiyo ilipitishwa.
`status`*	integer	3 - kuangalia kwa code ya pili bila kuongezeka kwa mfululizo; 6 - kuishia baada ya SMS; 8 - kuondoka mara moja.

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=setStatus.

Maombi ya mfano

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)

Maana ya

Kuangalia kwa SMS

ACCESS_RETRY_GET

ya kufikia

ACCESS_ACTIVATION

Kutoa kwa

ACCESS_CANCEL

Kutoa inachukua code ya pili ndani ya dakika 20 ya awali. kupoteza na muda wa mwisho haina mabadiliko.
Kwa hali ya3 matumizi Idempotency-Key: kukutana na maombi haitakuwa kurudi nyuma code mpya tayari alihitajika. SMS kuhifadhiwa kwa ajili ya.
Ulimwengu haina kuondoa faida zilizoanza.
Kila idadi ya SMS ya kuhifadhiwa katika historia. idadi ya kuondolewa na kufikia muda bila code ni kuondolewa.

GETgetRepeatNumberKisha, tena kuandika idadi ya

Inafungua mkutano mpya na idadi maalum kutoka kwa historia yako. Unaweza kuchagua huduma nyingine inayopatikana katika nchi hiyo.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.
`number`*	string	Idadi yako ya zamani. idadi tu na moja ya chaguo + ya kuongoza ni kutolewa.
`service`*	string	Kodi za huduma zinazopatikana.Jibu ni ya chini ya eneo la kuki ya API.
`session_duration`	integer	Mkutano huo una muda wa dakika 20. kufikia 20 au kuacha parameter hii.
`with_operator`	integer	1 huongeza ID ya opereta kwenye jibu; 0 au kutoweka kigezo hurudisha sehemu tatu.
`ref`	string	Kodi ya umma ya mteja wa programu: 5% kwa yeye na 5% kwa mteja. bila ref - 10% kwa mteja.
`operator`	string	Takeen ID ±a operators/getOperators (API). `operator=1 · any/0`

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getRepeatNumber.

Maombi ya mfano

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)

Maana ya

Mkutano mpya

ACCESS_NUMBER:43:380670000000

Idadi ya watu bado ni ya kuvutia

NUMBER_IN_USE

Kwanza, mwisho au kufuta sesioni yako ya sasa. Ikiwa idadi ni ya kuvutia, usiku wa tena haifai.
Mkutano mpya unapata ID mpya na takwimu ya sasa. SMS ya zamani haitakuwa imewekwa. ref inapatikana tena.
SMScash inawezesha kurejea tu idadi kutoka kwa historia ya akaunti hii. nchi inahusu kwa idadi.
Nyuma ya sesioni iliyotolewa bado inatumika: kurejesha upatikanaji na nyuma hiyo inatuma SESSION_CLOSED na haitatoa idadi nyingine.

GETgetSmsFullKuwasiliana na SMS kama JSON

Historia ya kujitegemea ya ujumbe wote na ID, mwalimu, code, maandishi na nchi, huduma na data ya mtoa huduma.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.
`id`*	integer	ID ya mkutano wako, alikubali wakati idadi hiyo ilipitishwa.

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getSmsFull.

Maombi ya mfano

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

Maana ya

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

Fomu ya mapendekezo ya kuingilia. kumbuka sms[].id kuendesha ujumbe mpya tu.
Hali ya idadi ya SMScash: 1 - ya kutosha, 6 - ya kutosha, 8 - ya kutosha au ya kutosha. status_name ina tofauti kati ya kusubiri, kupokea, kuishika, kutolewa, kutolewa, kutolewa.
Kodi zilizotokea ziko tayari baada ya kuondoka. Kwa volumi kubwa, kutumia REST /activations/{id}/sms na after_id.
Baada ya idadi ya watu bila SMS ya kuondolewa, getStatus na getSms Kutoa kwa STATUS_CANCEL; getSmsFull kurejesha hali ya kufungwa, simu ya kutosha na simu ya kutosha sms ya orodha. REST /activations/{id} na /sms Kutoa kwa 404 NO_ACTIVATION.

GETgetSmsKuingia SMS kama nyenzo ya maandishi

Kurejesha historia nzima ya SMS katika format ya nyota kwa wateja wa sasa.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.
`id`*	integer	ID ya mkutano wako, alikubali wakati idadi hiyo ilipitishwa.

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getSms.

Maombi ya mfano

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)

Maana ya

Maandamano ya

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

kuangalia

STATUS_WAIT_CODE

Ulimwengu au kuhariri

STATUS_CANCEL

lëng Message format: Time/code ë text. Multimes messages separates by a colon.
SMS mwenyewe inaweza kuwa na mzunguko na bar za mto. Kwa kuaminika, kutumia getSmsFull.

GETgetServicesHuduma

Kodi za huduma zinazopatikana.Jibu ni ya chini ya eneo la kuki ya API.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.
`country`	integer	Takeen ID ±a getCountries.

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getServices.

Maombi ya mfano

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

Maana ya

Huduma

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

Kadi ya huduma inahusishwa kwa mtoa huduma. idadi ya utoaji inahusishwa kwa kipekee.

GETgetCountriesNchi

IDs, majina na kodo ya simu kwa nchi katika channel iliyochaguliwa.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getCountries.

Maombi ya mfano

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

Maana ya

Nchi

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

GETgetOperatorswa operesheni

Waendeshaji wanaopatikana: kitambulisho cha API, jina na muda wa kushikilia malipo.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.
`country`	integer	Takeen ID ±a getCountries.
`operator`	string	Takeen ID ±a operators/getOperators (API). `operator=1 · any/0`

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getOperators.

Maombi ya mfano

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

Maana ya

wa operesheni

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

Takeen ID ±a operators/getOperators (API).

GETgetRewardsTuzo ya SMS

Bei ya fedha ni kwa nchi.Kila fedha za meza ni kwa SMS ya kulipwa.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.
`country`	integer	Takeen ID ±a getCountries.
`service`	string	Kodi za huduma zinazopatikana.Jibu ni ya chini ya eneo la kuki ya API.
`operator`	string	Takeen ID ±a operators/getOperators (API). `operator=1 · any/0`

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getRewards.

Maombi ya mfano

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

Maana ya

JSON

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

{}

{}

USD idadi ya fedha inakuja kama nyama ya kumi ya ukamilifu na 8 Mkutano wa wa:
Watoa wa uwezo wa kufikia nyenzo yako.
country ID → service code → operator ID → reward (USD)

GETgetBalanceSalio la mtumiaji

SMScash ya kuongeza: kiwango cha ziada kinachotumika kwa kuzingatia shida, bonuses ya kurudi na mahitaji ya malipo.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getBalance.

Maombi ya mfano

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)

Maana ya

Salio

ACCESS_BALANCE:0.00

getBalance Kutoa nyaraka zilizopo USD Mabadiliko ya juu ya 8 ya maeneo ya kumi.
Fedha zinaweza kutolewa tu baada ya muda wa kuzizuia kuisha.

GETgetHoldBalanceFedha zilizozuiliwa

Baada ya kupokea SMS, mapato huzuiliwa kwa muda uliowekwa na mtoa huduma. Katika tarehe iliyowekwa, kiasi hicho kinapatikana moja kwa moja kwa kutoa.

Mipango ya

Mipango ya	aina ya	Maelezo ya
`api_key`*	string	Ufunguo wa API wa mtumiaji.

* Mipango ya kuhitaji. katika maswali yote pia kuingia hatua=getHoldBalance.

Maombi ya mfano

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)

Maana ya

Fedha zilizozuiliwa

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
Fedha zinaweza kutolewa tu baada ya muda wa kuzizuia kuisha.

Maombi ya kurejesha na kurejesha maswali ya kurejesha

± In handler_api♫ .php business resultats normalement proveniente HTTP 200ë . check the corporate text. directorys and getSmsFull ± return JSON ==== Link==

Msimamo wa	HTTP	Sababu na hatua ya pili
`TARIFF_NOT_CONFIGURED`	200	Bei bado haijulikaniIdadi ya uagizo itaanza mara baada ya SMS awali ni kuagiza.
`COUNTRY_BLOCKED`	200	Idadi ya idadi ya nchi hii imechukuliwa.Tunaamua nchi nyingine.
`BAD_SERVICE`	200	Idadi ya usambazaji kwa huduma hii ni kuzuia.Tumia huduma nyingine.
`PROVIDER_NOT_READY`	200	± Number allocation non disponible temporarlyKuweka kwenye orodha ya API.
`BAD_KEY`	400	± No api_key ë format invalid.Angalia nyenzo katika mahitaji.
`INVALID_API_KEY`	401	Nyongeza ni kutokuwa na ujuzi, kuondolewa au akaunti imefunguliwa.Kuunda nyenzo ya API ya sahihi.
`BAD_COUNTRY`	400	Nchi inaonekana kuwa na au si idadi ya mafanikio.Takeen ID ±a getCountries.
`BAD_SESSION_DURATION`	400	Neno za simu zinapatikana kwa muda wa dakika 20.Korekt ± Korrekt session_duration.
`BAD_REQUEST`	400	ë invalid parameter or Idempotency-Key.Tafadhali uhakika kwa maombi yako.
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Makala ya kujua au kuharibu makala ya makala.Kuweka kwenye orodha ya API.
`BAD_NUMBER`	200	Ufafanuzi wa idadi ya faida.Kutoa idadi ya idadi katika idadi.
`BAD_ACTION / BAD_STATUS`	200	Ujumbe wa kutokuwa na ujuzi, ID au operesheni.Angalia mipango ya kuendesha.
`EMPTY_POOL`	200	Hakuna idadi ya simu ya kufikia sasa.Kuanzisha baada ya 10-30 Kuanzisha au kubadilisha filters.
`NUMBER_IN_USE`	200	Idadi fulani inachukuliwa na mkutano wa kutosha.Kuanzisha mkutano wako au kuchagua idadi nyingine.
`NO_ACTIVATION`	200	Siku au idadi ya awali si ya akaunti yako.Tazama ID na nyenzo.
`SESSION_CLOSED / SMS_REQUIRED`	200	Mabadiliko ya serikali kwa sasa haijawezekana.Tafadhali angalia hali na utaratibu wa SMS.
`SCOPE_BLOCKED`	200	Huduma, nchi, au mtoa huduma hawana mamlaka ya kufikia nyenzo.Kuendeleza ufanisi wa API.
`IDEMPOTENCY_CONFLICT`	200	Kazi hii ya kutafuta ni tayari ikilinganishwa na parameter nyingine.For a new operation, create other Idempotency-Key.
`BAD_REF / SELF_REF`	400	Kodi ya programu ni kutokuwa na ujuzi, au ni ya watumiaji mwenyewe.Kuanzisha code ya mteja wa programu.
`INTERNAL_ERROR`	500	* Temporary server or vendor error.Repetition with a tard and the same Idempotency-Key.
`ALLOCATION_PENDING`	200	♫ Number allocation is already in progress. Restart with the same Idempotency-Key.♫ Number allocation is already in progress. Restart with the same Idempotency-Key.
`ALLOCATION_UNCERTAIN`	200	Matokeo ya uagizo haikubalika. upungufu wa automatic ni haiwezekani kuepuka uagizo wa idadi ya pili.Matokeo ya uagizo haikubalika. upungufu wa automatic ni haiwezekani kuepuka uagizo wa idadi ya pili.

Kila kitu kinachotolewa kwa kurejea {"error":{"code":"…","message":"…"}} na hali ya HTTP ya kawaida 400/401/403/404/409/503.

JSON

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Angalia maeneo ya maombi.",
    "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.

Mwisho wa ushirikiano mpya

USD idadi ya fedha inakuja kama nyama ya kumi ya ukamilifu na 8 Mkutano wa wa: 0.00300000 USD.

Mabadiliko ya kiwango ni USD. Maombi na majibu ya mipango ya kufikia OpenAPI.

Kuondoka katika USDT · TRC20Malipo huchukua kati ya siku 1 na 45. Ada ya kutoa fedha ni 4 $. Inakatwa kutoka kiasi kilichoombwa. Baada ya kupokea SMS, mapato huzuiliwa kwa muda uliowekwa na mtoa huduma. Katika tarehe iliyowekwa, kiasi hicho kinapatikana moja kwa moja kwa kutoa. Fedha zinaweza kutolewa tu baada ya muda wa kuzizuia kuisha.

GET/api/v1/catalogHuduma na nchi

GET/api/v1/tariffsSMS ya kufa kwa nchi

GET/api/v1/offersBei na zawadi

GET/api/v1/servicesMsimamizi

GET/api/v1/countriesMsimamizi

GET/api/v1/operatorsMsimamizi

GET/api/v1/availability?country=1Idadi ya Uwezekano

POST/api/v1/activationsMkutano mpya

GET/api/v1/activations/batch?ids=42,43Kagua nambari kadhaa

GET/api/v1/activationsMkutano wa mwisho wa 200: ulimwengu = historia, kusubiri au wote

GET/api/v1/activations/{id}Mkutano na ujumbe

GET/api/v1/activations/{id}/sms?after_id=0&limit=100SMS ya kuingia kwa kursa

POST/api/v1/activations/{id}/retryKuangalia kwa SMS

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

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

POST/api/v1/activations/repeatIdadi ya kurejesha

GET/api/v1/keysAPI Nyuma ya

POST/api/v1/keysKuunda nyenzo

PATCH/api/v1/keys/{id}Mabadiliko ya jina au sera

DELETE/api/v1/keys/{id}Kutoa nyenzo

GET/api/v1/referralsMsimamo wa Msimamo na Faida

GET/api/v1/summaryMabadiliko na Mkataba

GET/api/v1/balanceFedha zilizozuiliwa

GET/api/v1/ledgerMsaada wa Ledger

GET/api/v1/withdrawalsMaombi ya malipo

POST/api/v1/withdrawalsKuunda maombi ya

GET/api/v1/statisticsTakwimu ya jumla

GET/api/v1/earnings/holdsKuzuia mapato

Kuwasiliana na SMS mpya tu

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

Kuokoa next_cursor na kuingia kwa njia ya after_idKama has_more=trueKwa mfano, ukurasa wa pili unaweza kusoma mara moja. limit: 1–200Mkutano wa Mkutano na SMS Ni inapatikana tu kwa mteja.