เริ่มต้น

ใบรับรอง API

หมายเลขข้อความและรายได้โดยตรงจากแอปของคุณ

GET

เริ่มต้นด้วยคําขอเดียว

13 · API คําสั่งREST + handler_api.phpJSON / plain text · Bearer

สร้างคีย์ API ในแผ่นดิสก์ของคุณรับหมายเลขและตรวจสอบข้อความทุก 20 วินาที การชําระเงินจะได้รับการรับรองเมื่อ SMS ที่มีรหัสมาถึง อ่านอีกครั้งจะไม่ส่งผลต่อสมดุลของคุณ

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

ความเข้ากันได้ API ฐาน URLhttps://smscash.org/stubs/handler_api.php

บริการอยู่หมายเลขโทรศัพท์ SMS และผลกําไรที่มีอยู่ การยกเลิกที่มีอยู่ใน USDT ใน TRC20การชําระเงินจะใช้ระหว่าง 1 และ 45 วัน

เริ่มต้นอย่างรวดเร็ว · 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}'

แผ่นดินทัศน์สมบูรณ์ที่สุดสมมุติที่เลือก: /handler_api.php. มีอยู่ REST ข้อมูลต่อไปทํางานต่อไป

REST API

ตัวสร้างคำขอ

cURL · Go · JS · Python

คําขอบริการ APIประเทศ APIผู้ประกอบการ operatorซอฟต์แวร์เจ้าของรหัส refIdempotency-Key

Idempotency-Key: UUID · POST · 8–128

เลือกอัตโนมัติ: ผู้ให้บริการที่มีรหัสมากที่สุดในชั่วโมงที่ผ่านมา แล้วจึงเทียบใน 24 ชั่วโมง หากไม่มีหมายเลข ให้ใช้ผู้ให้บริการถัดไป

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 คีย์

คีย์จะไม่ถูกบันทึก การตรวจสอบนี้จะไม่จัดสรรหมายเลข

ออกจากการรวมกันใหม่

บริการและประเทศ

เลือกบริการและประเทศ การชําระเงินโดย SMS ขึ้นอยู่กับประเทศ

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)

รับหมายเลข

REST

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

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

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

หมายเลขนั้นถูกต้อง 20 นาที SMS จะตรวจสอบทุก 20 วินาที คุณสามารถยกเลิกได้ทันที

ตรวจสอบหลายหมายเลข

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

ยอดเงิน · เงินที่ถูกพักไว้

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 — ใช้ได้; held_balance — เงินที่ถูกพักไว้. USD · 8

ถอนได้เฉพาะเงินที่พ้นระยะพักเงินแล้ว

ไคลเอนต์พร้อมใช้งาน

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 · ความเข้ากันได้ API ฐาน URLhttps://smscash.org/sms-activate/stubs/handler_api.php

HeroSMS · ความเข้ากันได้ API ฐาน URLhttps://smscash.org/hero-sms/stubs/handler_api.php

คีย์ API ส่วนตัวของผู้ใช้

เลือกบริการและประเทศ การชําระเงินโดย SMS ขึ้นอยู่กับประเทศ

รหัส	คําอธิบาย
`getNumber / getNumberV2`	รับหมายเลข
`getStatus / getStatusV2`	รับรหัสล่าสุด
`setStatus / finishActivation / cancelActivation`	การจัดการเซสชั่น
`getPrices / getNumbersStatus`	ตรวจสอบความพร้อมใช้งาน
`getRewards (SMScash)`	โพสต์สําหรับ SMS
`getServicesList / getServices`	บริการ
`getCountries / getOperators`	บริการและประเทศ
`getActiveActivations`	การประชุม
`getBalance`	ยอดคงเหลือของผู้ใช้
`getHoldBalance (SMScash)`	เงินที่ถูกพักไว้

cost = 0 USD · activationCost = 0 USD
reward — โพสต์สําหรับ 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'

คําตอบ

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

การรับรองและการยื่นออก

REST: หัวหน้า Authorization: Bearer YOUR_API_KEY. อินเตอร์เฟซที่เข้ากันได้: พารามิเตอร์ api_key และ actionใช้ HTTPS

เพื่อจัดการคีย์ API, เข้าสู่บัญชีของคุณ

∞คําขอ / นาทีต่อบัญชี

∞การประชุมแบบกันนัด

ความถี่ที่คําขอ API และจํานวนหมายเลขโทรศัพท์ไม่ จํากัด ไม่มีค่าใช้จ่ายประจําวันหรือชั่วโมง

ในส่วนที่เหลือหนึ่ง Idempotency-Key ต้องการการจัดหาหมายเลขการจัดหาการตอบกลับและการชําระเงินคําขอ เป็นตัวเลือก แต่แนะนําใน handler_api.php ใช้ใหม่คีย์เมื่อการตอบกลับคําขอเครือข่าย ใช้คีย์ใหม่สําหรับการดําเนินการใหม่

API หลัก

คุณสามารถ จํากัด ปุ่มสําหรับบริการที่เฉพาะเจาะจงประเทศและผู้ให้บริการ รายการว่างเปล่าช่วยให้เลือกทั้งหมดที่มีอยู่

JSON

{
  "label": "ซอฟต์แวร์ของฉัน",
  "policy": {
    "services": [
      "go"
    ],
    "countries": [
      86
    ],
    "providers": [
      1
    ]
  }
}

PATCH /api/v1/keys/{id} เปลี่ยนชื่อและนโยบายอย่างสมบูรณ์ ความลับจะแสดงเฉพาะเมื่อสร้างขึ้น

10% ในทั้งหมด 5% + 5% ด้วยรหัสซอฟต์แวร์

เมื่อออกหมายเลขโปรดให้ ref ผู้ถือซอฟต์แวร์ คําขอได้รับการอนุมัติโดยคีย์ผู้ดําเนินการ รหัสอยู่ในส่วน "การอ้างอิง" และใน GET /api/v1/referrals → software_ref.

คําขอ	เสนอ	ซอฟต์แวร์
ไม่มี REF	10%	—
ด้วย REF	5%	5%
ด้วย ref ไม่มีการพูด	—	5%

พลั๊กอินจ่ายเงินโบนัสโดยไม่ต้องลดรายได้ของผู้ใช้ ผู้ถือซอฟต์แวร์และผู้ส่งข้อความสามารถเป็นบุคคลเดียวกัน ผู้ใช้ไม่สามารถใช้รหัสของตัวเอง

เงื่อนไขจะกําหนดเมื่อการประชุมถูกสร้างขึ้น อ่านข้อความ SMS และการคืนเงินไม่เปลี่ยนแปลงพวกเขา Pass ref อีกครั้งสําหรับการประชุมการตอบสนองใหม่ ในคํานวณค่าธรรมเนียมรางวัลผู้ใช้ USD 0.003 ให้ USD 0.00015 ต่อไปกับเจ้าของซอฟต์แวร์และผู้ติดต่อ โบนัสทั้งหมดคือ USD 0.00030.

API คําสั่ง

11 วิธีการสไตล์ XVBC รวมถึงสมดุล SMScash ของคุณ

GETgetNumberรับหมายเลข

สร้างเซสชั่นและจัดเก็บหมายเลขที่มีให้สําหรับผู้ใช้ อัตรารางวัลและผู้รับการส่งมอบจะถูกกําหนดไว้ในค่าใช้จ่าย; อัตรารางวัลจะถูกรับเงินเมื่อ SMS ที่มีรหัสมาถึง

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้
`service`*	string	รหัสบริการที่มีอยู่ คําตอบจะ จํากัด ในพื้นที่ของคีย์ API
`country`*	integer	เอา ID จาก getCountries.
`operator`	string	เอา ID จาก operators/getOperators (API). `operator=1 · any/0`
`session_duration`	integer	การประชุมใช้เวลา 20 นาที ลบ 20 หรือลบพารามิเตอร์นี้
`with_operator`	integer	1 เพิ่ม ID ผู้ให้บริการในคำตอบ; 0 หรือไม่ระบุพารามิเตอร์จะคืนค่าสามส่วน
`ref`	string	รหัสสาธารณะของเจ้าของซอฟต์แวร์: 5% สําหรับเขาและ 5% สําหรับผู้เข้าชม ไม่มีเงินฝาก - 10% สําหรับผู้เข้าชม

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getNumber

คําขอตัวอย่าง

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)

คําตอบ

หมายเลขที่ได้รับ

ACCESS_NUMBER:42:380670000000:1

ไม่มีหมายเลขที่มีอยู่

EMPTY_POOL

เลือกอัตโนมัติ: ผู้ให้บริการที่มีรหัสมากที่สุดในชั่วโมงที่ผ่านมา แล้วจึงเทียบใน 24 ชั่วโมง หากไม่มีหมายเลข ให้ใช้ผู้ให้บริการถัดไป
ผ่าน Idempotency-Key: ขอร้องเดียวกับกุญแจเดียงกัน จะคืนสัมพันธ์ก่อน เปลี่ยนโทรศัพท์ IDEMPOTENCY_CONFLICT.
ประเทศที่ไม่มีสระว่ายน้ําจะให้ EMPTY_POOL; ภาษาที่ผิดเป็น BAD_COUNTRY
ปุ่มเซสชั่นที่ลบยังคงใช้: การเล่นการจัดหาใหม่ด้วยคีย์นั้นจะส่ง SESSION_CLOSED และไม่ปล่อยหมายเลขอื่น ๆ
ผลการจัดหาไม่ได้ยืนยัน การรีดอัตโนมัติจะถูกปิดกั้นเพื่อหลีกเลี่ยงการจัดหาหมายเลขที่สอง

GETgetNumbersStatusตรวจสอบความพร้อมใช้งาน

มีหมายเลขโทรศัพท์ตามบริการและประเทศ

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้
`country`*	integer	เอา ID จาก getCountries.

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getNumbersStatus

คําขอตัวอย่าง

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

คําตอบ

หมายเลขที่มีอยู่

{
  "go_0": 0
}

_0 suffix คือการเลือกโดยไม่มีผู้ประกอบการเฉพาะ
การมีอยู่หมายถึงสระว่ายน้ําทั้งหมดของซัพพลายเออร์ ช่องที่เลือกจะถูกตรวจสอบเมื่อหมายเลขถูกจัดให้

GETgetStatusรับรหัสล่าสุด

คําของ่ายสําหรับสถานะการประชุมและรหัส SMS ที่สุดท้าย หมายเลขที่นําในรหัสจะถูกเก็บไว้

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้
`id`*	integer	ID ของการประชุมของคุณได้รับเมื่อหมายเลขได้รับการปล่อยตัว

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getStatus

คําขอตัวอย่าง

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)

คําตอบ

รอ

STATUS_WAIT_CODE

รหัสที่ได้รับ

STATUS_OK:001234

การยกเลิกหรือหมดอายุ

STATUS_CANCEL

ไม่พบ

NO_ACTIVATION

Poll ทุก 20 วินาที อ่านข้อความอีกครั้งไม่สร้างการชําระเงินอีกต่อไป
หลังจากรีดรหัสเก่าจะไม่กลับมา: getStatus รอสําหรับข้อความ SMS ต่อไป
หลังจากจํานวนที่ไม่มี SMS ถูกลบ getStatus และ getSms กลับมา STATUS_CANCEL; getSmsFull คืนสถานการณ์ปิด, โทรศัพท์ที่เปลี่ยนแปลง และสําเร็จ sms รายชื่อ REST /activations/{id} และ /sms กลับมา 404 NO_ACTIVATION.

GETsetStatusการจัดการเซสชั่น

เสร็จสิ้นการยกเลิกหรือเรียกคืนการรอ SMS. การสิ้นสุดการประชุมยังคงเหมือนกัน

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้
`id`*	integer	ID ของการประชุมของคุณได้รับเมื่อหมายเลขได้รับการปล่อยตัว
`status`*	integer	3 - รอสําหรับรหัสต่อไปโดยไม่ต้องขยายเซสชั่น 6 - หมดหลังจาก SMS 8 - อะลูกรอกทันที

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=setStatus

คําขอตัวอย่าง

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)

คําตอบ

รอ SMS

ACCESS_RETRY_GET

ใบสมัคร

ACCESS_ACTIVATION

อะลอ

ACCESS_CANCEL

Retry รอสําหรับรหัสต่อไปภายใน 20 นาทีเดิม เวลาการปล่อยและเวลาสิ้นสุดไม่เปลี่ยนแปลง
สําหรับ status=3 ใช้ Idempotency-Key: การทําซ้ําคําขอจะไม่ตั้งค่าใหม่รหัสที่ได้รับแล้ว ประวัติของ SMS ยังคงมี
การยกเลิกไม่ลบรางวัลที่ได้รับแล้ว
เท่านั้นหมายเลขที่มีรหัส SMS จะถูกเก็บไว้ในประวัติ หมายเลขที่ลบและหมดอายุโดยไม่มีรหัสจะถูกลบ

GETgetRepeatNumberหมายเลขเดียวกันอีกครั้ง

เปิดเซสชั่นใหม่ที่มีหมายเลขเฉพาะจากประวัติของคุณ คุณสามารถเลือกบริการอื่นที่มีอยู่ในประเทศเดียวกัน

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้
`number`*	string	หมายเลขเก่าของคุณเท่านั้นและหมายเลข + ที่เลือกจะได้รับอนุญาต
`service`*	string	รหัสบริการที่มีอยู่ คําตอบจะ จํากัด ในพื้นที่ของคีย์ API
`session_duration`	integer	การประชุมใช้เวลา 20 นาที ลบ 20 หรือลบพารามิเตอร์นี้
`with_operator`	integer	1 เพิ่ม ID ผู้ให้บริการในคำตอบ; 0 หรือไม่ระบุพารามิเตอร์จะคืนค่าสามส่วน
`ref`	string	รหัสสาธารณะของเจ้าของซอฟต์แวร์: 5% สําหรับเขาและ 5% สําหรับผู้เข้าชม ไม่มีเงินฝาก - 10% สําหรับผู้เข้าชม
`operator`	string	เอา ID จาก operators/getOperators (API). `operator=1 · any/0`

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getRepeatNumber

คําขอตัวอย่าง

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)

คําตอบ

การประชุมใหม่

ACCESS_NUMBER:43:380670000000

จํานวนยังคง忙碌

NUMBER_IN_USE

ก่อนอื่นเสร็จสิ้นหรือยกเลิกการประชุมปัจจุบันของคุณ หากหมายเลข忙碌แล้วการส่งออกใหม่จะไม่ดําเนินการ
การประชุมใหม่จะได้รับ ID ใหม่และค่าธรรมเนียมปัจจุบัน SMS เก่าไม่ได้คัดลอกลงในมัน ref จะตั้งค่าอีกครั้ง
SMScash ช่วยให้สามารถทําซ้ําหมายเพียงแค่จํานวนจากประวัติบัญชีนี้ ประเทศที่ระบุโดยหมายเลข
ปุ่มเซสชั่นที่ลบยังคงใช้: การเล่นการจัดหาใหม่ด้วยคีย์นั้นจะส่ง SESSION_CLOSED และไม่ปล่อยหมายเลขอื่น ๆ

GETgetSmsFullรับ SMS เป็น JSON

ประวัติศาสตร์ที่สร้างขึ้นของข้อความทั้งหมดที่มี ID, ส่งสัญญาณ, รหัส, ข้อความและประเทศ, บริการและข้อมูลผู้จัดจําหน่าย

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้
`id`*	integer	ID ของการประชุมของคุณได้รับเมื่อหมายเลขได้รับการปล่อยตัว

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getSmsFull

คําขอตัวอย่าง

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

คําตอบ

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

โปรดจํา sms[].id เพื่อประมวลผลข้อความใหม่เท่านั้น
สภาพแวดล้อม SMScash: 1 - มีการใช้งาน 6 - หมดอายุ 8 - อะลอหรือหมดอายุ status_name จะแยกระหว่างรอ, ได้รับ, หมดอายุ, อะลอ, หมดอายุ
รหัสที่ได้รับยังคงมีอยู่หลังจากที่เซสชั่นจะปิด สําหรับปริมาณขนาดใหญ่ใช้ REST /activations/{id}/sms กับ after_id
หลังจากจํานวนที่ไม่มี SMS ถูกลบ getStatus และ getSms กลับมา STATUS_CANCEL; getSmsFull คืนสถานการณ์ปิด, โทรศัพท์ที่เปลี่ยนแปลง และสําเร็จ sms รายชื่อ REST /activations/{id} และ /sms กลับมา 404 NO_ACTIVATION.

GETgetSmsรับ SMS เป็นข้อความ string

กลับประวัติ SMS ทั้งหมดในรูปแบบ string สําหรับลูกค้าที่มีอยู่

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้
`id`*	integer	ID ของการประชุมของคุณได้รับเมื่อหมายเลขได้รับการปล่อยตัว

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getSms

คําขอตัวอย่าง

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)

คําตอบ

ข้อความ

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

รอ

STATUS_WAIT_CODE

การยกเลิกหรือหมดอายุ

STATUS_CANCEL

รูปแรกข้อความ: เวลา code ë text. ส่วนข้องแยกกันโดยคูล
ข้อความ SMS ตัวเอง อาจ มี คู่ เมือง และ บาร์ แท็กต์. getSmsFull.

GETgetServicesบริการ

รหัสบริการที่มีอยู่ คําตอบจะ จํากัด ในพื้นที่ของคีย์ API

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้
`country`	integer	เอา ID จาก getCountries.

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getServices

คําขอตัวอย่าง

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

คําตอบ

บริการ

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

แพทย์บริการแบ่งปันทั่วผู้จัดจําหน่าย การตรวจสอบการมีจําหน่ายหมายเลขเป็นแยกต่างหาก

GETgetCountriesประเทศ

IDs, ชื่อและรหัสการโทรสําหรับประเทศในช่องที่เลือก

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getCountries

คําขอตัวอย่าง

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

คําตอบ

ประเทศ

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

GETgetOperatorsผู้ประกอบการ

ผู้ให้บริการที่พร้อมใช้งาน: ID API ชื่อ และระยะเวลาพักยอดรางวัล

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้
`country`	integer	เอา ID จาก getCountries.
`operator`	string	เอา ID จาก operators/getOperators (API). `operator=1 · any/0`

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getOperators

คําขอตัวอย่าง

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

คําตอบ

ผู้ประกอบการ

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

เอา ID จาก operators/getOperators (API).

GETgetRewardsโพสต์สําหรับ SMS

อัตราขึ้นอยู่กับประเทศทั้งหมดจํานวนเงินโต๊ะเป็นค่าใช้จ่าย SMS

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้
`country`	integer	เอา ID จาก getCountries.
`service`	string	รหัสบริการที่มีอยู่ คําตอบจะ จํากัด ในพื้นที่ของคีย์ API
`operator`	string	เอา ID จาก operators/getOperators (API). `operator=1 · any/0`

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getRewards

คําขอตัวอย่าง

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

คําตอบ

JSON

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

{}

{}

หมายเลขภาษี USD จะถูกคืนเป็นเส้นด้ายดั้งเดิมที่ถูกต้องด้วย 8 จุดดั้งเดิม:
ผู้ให้บริการที่เปิดใช้งานพร้อมกับคีย์ของคุณ
country ID → service code → operator ID → reward (USD)

GETgetBalanceยอดคงเหลือของผู้ใช้

SMScash เพิ่ม: ค่าเงินสดที่มีอยู่ตามการรับเงินสดโบนัสการส่งมอบและคําขอชําระเงิน

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getBalance

คําขอตัวอย่าง

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)

คําตอบ

ยอดเงิน

ACCESS_BALANCE:0.00

getBalance จะคืนค่าสกุลเงิน USD ที่พร้อมกับสถานที่ที่ 8 ตัน
ถอนได้เฉพาะเงินที่พ้นระยะพักเงินแล้ว

GETgetHoldBalanceเงินที่ถูกพักไว้

หลังจากได้รับ SMS รายได้จะถูกพักไว้ตามระยะเวลาที่ผู้ให้บริการกำหนด เมื่อถึงวันที่กำหนด เงินจะพร้อมให้ถอนโดยอัตโนมัติ

พารามิเตอร์

พารามิเตอร์	ประเภท	คําอธิบาย
`api_key`*	string	คีย์ API ส่วนตัวของผู้ใช้

* พารามิเตอร์ที่จําเป็น ในคําขอทั้งหมดยังผ่านการกระทํา=getHoldBalance

คําขอตัวอย่าง

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)

คําตอบ

เงินที่ถูกพักไว้

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
ถอนได้เฉพาะเงินที่พ้นระยะพักเงินแล้ว

รหัสตอบสนองและคําขอที่ซ้ํากัน

เข้าไป handler_apiผลธุรกิจพิเศษปกติมาด้วย HTTP 200ตรวจสอบข้อความของร่างกาย และ getSmsFull กลับมา JSON ถ้าเป็นความสําเร็จ; ความผิดพลาดคือข้อความตลอดไป

รหัส	HTTP	สาเหตุและขั้นตอนต่อไป
`TARIFF_NOT_CONFIGURED`	200	อัตรายังไม่ได้ตั้งค่าการจัดหาหมายเลขจะเริ่มเมื่อการโบนัส SMS ได้รับการกําหนดค่า
`COUNTRY_BLOCKED`	200	การจัดหาหมายเลขสําหรับประเทศนี้ถูกบล็อกเลือกประเทศอื่น ๆ
`BAD_SERVICE`	200	จํานวนการจัดหาสําหรับบริการนี้ถูกบล็อกเลือกบริการอื่น ๆ
`PROVIDER_NOT_READY`	200	การจัดหาหมายเลขเป็นเวลาไม่สามารถใช้ได้ปรับปรุงคอลัมน์ API
`BAD_KEY`	400	ไม่ api_key หรือรูปแบบไม่ถูกต้องตรวจสอบคีย์ในคําขอ
`INVALID_API_KEY`	401	คีย์ที่ไม่ทราบหรือถอนหรือบัญชีปิดใช้งานสร้างคีย์ API ที่ถูกต้อง
`BAD_COUNTRY`	400	ประเทศมีขาดหรือไม่มีหมายเลขที่บวกเอา ID จาก getCountries.
`BAD_SESSION_DURATION`	400	หมายเลขโทรศัพท์จะถูกส่งเป็นเวลา 20 นาทีถูกต้อง session_duration.
`BAD_REQUEST`	400	ปาราเมอร์ไม่ถูกต้องหรือ Idempotency-Key.โปรดแก้ไขคําขอของคุณ
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	รายการไดเรกทอรีที่ไม่ทราบหรือผิดปกติปรับปรุงคอลัมน์ API
`BAD_NUMBER`	200	หมายเลขที่ผิดปกติหมายเลขให้เป็นดิจิตอล
`BAD_ACTION / BAD_STATUS`	200	การสั่งซื้อ ID หรือการดําเนินการที่ไม่ได้รับการระบุตรวจสอบการตั้งค่า
`EMPTY_POOL`	200	ไม่มีหมายเลขโทรศัพท์ที่ตรงกันข้ามในปัจจุบันสัปดาห์ละครั้งหลังจาก 10-30 วินาทีหรือเปลี่ยนกรอง
`NUMBER_IN_USE`	200	หมายเลขที่เฉพาะเจาะจงจะถูกครอบครองโดยการประชุมที่ใช้งานได้ปิดเซสชั่นของคุณหรือเลือกหมายเลขอื่น ๆ
`NO_ACTIVATION`	200	การประชุมหรือหมายเลขก่อนหน้านี้ไม่ได้อยู่ในบัญชีของคุณตรวจสอบ ID และคีย์
`SESSION_CLOSED / SMS_REQUIRED`	200	การเปลี่ยนแปลงของรัฐในปัจจุบันไม่สามารถใช้ได้ตรวจสอบสถานะและมีอยู่ของ SMS
`SCOPE_BLOCKED`	200	บริการประเทศหรือผู้จําหน่ายไม่ได้รับอนุญาตสําหรับกุญแจปรับปรุงช่วงของ API Key
`IDEMPOTENCY_CONFLICT`	200	คีย์คําถามนี้มีส่วนร่วมกับพารามิเตอร์อื่น ๆสําหรับปฏิบัติการใหม่ สร้างอีกอย่าง Idempotency-Key.
`BAD_REF / SELF_REF`	400	รหัสซอฟต์แวร์ไม่ทราบหรือผิดพลาดหรือเป็นเจ้าของของผู้ใช้เองใส่รหัสของเจ้าของซอฟต์แวร์
`INTERNAL_ERROR`	500	ข้อผิดพลาดเซิร์ฟเวอร์หรือผู้จําหน่ายคูณอีกครั้ง ด้วยความละเอียดและเดียวกัน Idempotency-Key.
`ALLOCATION_PENDING`	200	ข้อมูลจํานวนกําลังผ่านมาแล้ว Idempotency-Key.ข้อมูลจํานวนกําลังผ่านมาแล้ว Idempotency-Key.
`ALLOCATION_UNCERTAIN`	200	ผลการจัดหาไม่ได้ยืนยัน การรีดอัตโนมัติจะถูกปิดกั้นเพื่อหลีกเลี่ยงการจัดหาหมายเลขที่สองผลการจัดหาไม่ได้ยืนยัน การรีดอัตโนมัติจะถูกปิดกั้นเพื่อหลีกเลี่ยงการจัดหาหมายเลขที่สอง

REST กลับวัตถุ {"error":{"code":"…","message":"…"}} และปกติ HTTP ตําแหน่ง 400/401/403/404/409/503.

JSON

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "ตรวจสอบฟิลด์คําขอ",
    "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.

ออกจากการรวมกันใหม่

หมายเลขภาษี USD จะถูกคืนเป็นเส้นด้ายดั้งเดิมที่ถูกต้องด้วย 8 จุดดั้งเดิม: 0.00300000 USD.

สกุลเงินสมดุลคือ USD. คําขอและคําตอบ schemes มีอยู่ใน OpenAPI.

การถอนเงินใน USDT · TRC20การจ่ายเงินใช้เวลา 1 ถึง 45 วัน ค่าธรรมเนียมการถอนคือ 4 $ โดยหักจากจำนวนเงินที่ขอถอน หลังจากได้รับ SMS รายได้จะถูกพักไว้ตามระยะเวลาที่ผู้ให้บริการกำหนด เมื่อถึงวันที่กำหนด เงินจะพร้อมให้ถอนโดยอัตโนมัติ ถอนได้เฉพาะเงินที่พ้นระยะพักเงินแล้ว

GET/api/v1/catalogบริการและประเทศ

GET/api/v1/tariffsSMS อัตรารางวัลตามประเทศ

GET/api/v1/offersอัตราและรางวัล

GET/api/v1/servicesหลักสูตร

GET/api/v1/countriesหลักสูตร

GET/api/v1/operatorsหลักสูตร

GET/api/v1/availability?country=1หมายเลขความพร้อม

POST/api/v1/activationsการประชุมใหม่

GET/api/v1/activations/batch?ids=42,43ตรวจสอบหลายหมายเลข

GET/api/v1/activations200 ครั้งล่าสุด: scope = เรื่องราว, รอ หรือทั้งหมด

GET/api/v1/activations/{id}การประชุมและข้อความ

GET/api/v1/activations/{id}/sms?after_id=0&limit=100SMS ใหม่พร้อม cursor

POST/api/v1/activations/{id}/retryรอ SMS

POST/api/v1/activations/{id}/finishการเสร็จสิ้น

POST/api/v1/activations/{id}/cancelอะลอ

POST/api/v1/activations/repeatหมายเลขการเดินทาง

GET/api/v1/keysAPI คีย์

POST/api/v1/keysสร้างกุญแจ

PATCH/api/v1/keys/{id}เปลี่ยนชื่อหรือนโยบาย

DELETE/api/v1/keys/{id}คีย์ที่ลบ

GET/api/v1/referralsรหัสการอ้างอิงและผลกําไร

GET/api/v1/summaryหมายเลขที่กําหนดและคํานวณ

GET/api/v1/balanceเงินที่ถูกพักไว้

GET/api/v1/ledgerหมายเลขรุ่น: Ledger

GET/api/v1/withdrawalsคําขอชําระเงิน

POST/api/v1/withdrawalsสร้างคําขอ

GET/api/v1/statisticsสถิติทั้งหมด

GET/api/v1/earnings/holdsการพักรายได้

รับ SMS ใหม่เท่านั้น

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

บันทึก next_cursor และจงส่งมันเป็น after_id.. ถ้า has_more=true, หน้าถัดไปอาจจะอ่านทันที. จัดการ: 1–200ช่วงสถานการณ์ SMS มีเพียงผู้เป็นเจ้า