დაიწყოს

API რეგისტრაციის

რიცხვი, ცნობები და პროგრამა, პარამეტრები შორის გაქვს პოლიცია.

GET

საათის განმავლობაში მოთხოვნილება

13 · API მოწყობილობებიREST + handler_api.phpJSON / plain text · Bearer

Create ერთი API Key in your dashboard, მიიღეთ number და შეგიძლიათ გამოიყენოთ ნებისმიერ პოსტს 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}'

Alternative compatible interface address: /handler_api.php. არსებობს REST ინსტრუმენტი მუშაობს.

REST API

მოთხოვნების შემქმნელი

cURL · Go · JS · Python

მოთხოვნილებადასახელება APIქვეყანა APIპროექტის operatorპროგრამული საფუძვლები ReF CodeIdempotency-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 Key (გამარჯვებული)

გასაღები არ ინახება. ეს შემოწმება ნომრებს არ გასცემს.

New Integrations-ის გამოყენებით

სერვისები და ქვეყნები

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა 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 გასაღები.

Code რეგისტრაცია	აღწერა
`getNumber / getNumberV2`	მიიღეთ რამდენიმე
`getStatus / getStatusV2`	მიიღეთ საუკეთესო კოდი
`setStatus / finishActivation / cancelActivation`	Session რეგისტრაციის
`getPrices / getNumbersStatus`	გამოცდილება Availability
`getRewards (SMScash)`	SMS-ის გამოყენებით
`getServicesList / getServices`	სერვისები
`getCountries / getOperators`	სერვისები და ქვეყნები
`getActiveActivations`	SESSION
`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.

განცხადებები და განცხადებები Retries

REST: Head Authorization: Bearer YOUR_API_KEY. მოდური მოდური მოდური: Parameters api_key და actionგამოყენებით HTTPS.

API გასაღები

∞განცხადებები / წუთის განმავლობაში

∞simultaneous შეხვედრები

API მოთხოვნილება ფუნქცია და ტელეფონები არ არის უსაფრთხო. არ არსებობს ყოველდღიური ან სათამაშო ფუნქცია.

უნიკალური რესტის საშუალება Idempotency-Key არსებობს რიცხვის განყოფილების მისაღებად, მოხსენიებული მონაწილეობა retry და პატივისცემის მოთხოვნილებები. handler_api.php. გასაღები ახალი ოპერაციისთვის გამოიყენეთ.

API Key scope (მდე მისასვლელად)

შეგიძლიათ განსაკუთრებული მსახურების, ქვეყნებისა და მომზადებლების გასაღები დააშოროთ.

JSON

{
  "label": "My პროგრამული",
  "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 და retry ნწმა ეა დთ ოპჲმვნთქ. ref ახალი შემთხვევის შესახებ ახლა. ტარიფის პასუხის ჯანმრთელობა USD 0.003 მოცემულია USD 0.00015 თითოეული პროგრამის ოპერაციის და რეფერორი. USD 0.00030.

API მოწყობილობები

11 XVBC-მდე მისასვლელად და თქვენს SMScash-მდე მისასვლელად.

GETgetNumberმიიღეთ რამდენიმე

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა SMS მოდელი კოდი მოვიდა.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.
`service`*	string	Available service codes. პასუხი არის უზრუნველყოფს API Key-ის საფუძველი.
`country`*	integer	მიიღეთ ID Mადლობა getCountries.
`operator`	string	მიიღეთ ID Mადლობა operators/getOperators (API). `operator=1 · any/0`
`session_duration`	integer	20 საათის განმავლობაში. წასვლა 20 ან არასოდეს გააკეთე ეს ფუნქცია.
`with_operator`	integer	1 პასუხს ოპერატორის ID-ს ამატებს; 0 ან გამოტოვებული პარამეტრი სამ ნაწილს აბრუნებს.
`ref`	string	Public code of the software owner: 5% for him and 5% for the inviter. რეგისტრაციის გარეშე - 10% for the inviter.

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getNumber.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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)

პასუხი

number გაკეთებული

ACCESS_NUMBER:42:380670000000:1

არ არსებობს არჩევნები

EMPTY_POOL

ავტომატური არჩევა: ყველაზე მეტი კოდი ბოლო საათში, შემდეგ 24 საათში. ნომრები არ არის: შემდეგი ოპერატორი.
Pass Idempotency-Key: იგივე მოთხოვნით იგივე მოთხოვნით მოთხოვნილია პირველ შეხვედრაში. მოთხოვნილება IDEMPOTENCY_CONFLICT.
პუბლიკაციის გარეშე ციფრული ქვეყნიერება EMPTY_POOL აძლევს; არასწორი ქალაქის ფორმატი BAD_COUNTRY არის.
The key of a deleted session remains used: replaying allocation with that key returns SESSION_CLOSED და არ გამოიყურება სხვა number.
მონაწილეობის შედეგები არ არის დარწმუნებული. ავტომატური ცდილობები გაუშვებაა, რათა მეორე რიცხვის გამოყენება არაა.

GETgetNumbersStatusგამოცდილება Availability

ტელეფონები, რომლებიც შეგიძლიათ გააკეთოთ ტელეფონები, ტელეფონები და ტელეფონები.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.
`country`*	integer	მიიღეთ ID Mადლობა getCountries.

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getNumbersStatus.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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მიიღეთ საუკეთესო კოდი

Easy request for session status and last SMS code. კატეგორიაში ჩრდილოეთ კატეგორიები დატვირთული.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.
`id`*	integer	ID თქვენი სათამაშო, მიიღო, როდესაც ტელეფონი გაიმართა.

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getStatus.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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)

პასუხი

გამოგზავნილია: May ,

STATUS_WAIT_CODE

Code მიიღო

STATUS_OK:001234

Cancellation ან მოწყობილობები

STATUS_CANCEL

არ ჩანს

NO_ACTIVATION

20 საათის განმავლობაში. წერილის გაკეთება არასოდეს გააკეთებს სხვა ფასდაკლება.
შემდეგ retry არ ჩაწერილა ძველი კოდი: getStatus გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა SMS.
რამდენიმე წუთის წინ, არასოდეს SMS გამოქვეყნებული იყო, getStatus და getSms Return (გამარჯვება) STATUS_CANCEL; getSmsFull გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა sms სურათები . REST /activations/{id} და /sms Return (გამარჯვება) 404 NO_ACTIVATION.

GETsetStatusSession რეგისტრაციის

შეასრულება, შეასრულება ან შეასრულება შეასრულება SMS. შეასრულება შეასრულება იგივე.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.
`id`*	integer	ID თქვენი სათამაშო, მიიღო, როდესაც ტელეფონი გაიმართა.
`status`*	integer	3 — მოვიდა შემდეგი კოდი, არასოდეს გაკეთებული სათამაშო; 6 — გაკეთებული შემდეგ SMS; 8 — გაკეთებული მალე.

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=setStatus.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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

Cancelled

ACCESS_CANCEL

Retry მოვიდა შემდეგი კოდი 20 წუთის განმავლობაში. მოწყობილობები და მოწყობილობები არ შეიცავს.
სტატუსისთვის=3 გამოყენება Idempotency-Key: მოთხოვნის აღდგენა ახალი კოდი უკვე მიიღო. ისტორია SMS დარჩენილია.
Cancellation არ გაკეთებს გაკეთებული ბონუსები.
SMS-ის კოდი მხოლოდ ტელეფონები განახორციელდება ტელეფონში. ტელეფონები, რომლებიც გაკეთებული და გაკეთებული არ არსებობს ტელეფონები, გაკეთებულია.

GETgetRepeatNumberამავე რიცხვის კვლავ გახსენება

თქვენი ისტორიიდან განსაკუთრებული რიცხვის ახალი სესიის გახსნა. შეგიძლიათ ამავე ქვეყნიერებაში სხვა შესახებ მსახურების არჩევა.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.
`number`*	string	მხოლოდ ნომერები და არჩევნების საფეხბურთო + გათვალისწინებული.
`service`*	string	Available service codes. პასუხი არის უზრუნველყოფს API Key-ის საფუძველი.
`session_duration`	integer	20 საათის განმავლობაში. წასვლა 20 ან არასოდეს გააკეთე ეს ფუნქცია.
`with_operator`	integer	1 პასუხს ოპერატორის ID-ს ამატებს; 0 ან გამოტოვებული პარამეტრი სამ ნაწილს აბრუნებს.
`ref`	string	Public code of the software owner: 5% for him and 5% for the inviter. რეგისტრაციის გარეშე - 10% for the inviter.
`operator`	string	მიიღეთ ID Mადლობა operators/getOperators (API). `operator=1 · any/0`

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getRepeatNumber.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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)

პასუხი

New Session (ქართულად) ახალი საათი

ACCESS_NUMBER:43:380670000000

რიცხვი ჯერ კიდევ დაბეჭდებულია

NUMBER_IN_USE

პირველი, დასრულება ან შენს მიმდინარე სექსიის შენარჩუნება. თუ რიცხვი დასრულებულია, კვლავაც არ შესრულდება.
New Session receives a new ID and the current tariff. ძველი SMS არ ჩაწერილა. ref არის ჩაწერილი კიდევ ერთხელ.
SMScash შეგიძლიათ გამოიყენოთ მხოლოდ ტელეფონები ამ ანგარიში. ამ ქვეყანას გამოიყენება ტელეფონები.
The key of a deleted session remains used: replaying allocation with that key returns SESSION_CLOSED და არ გამოიყურება სხვა number.

GETgetSmsFullSMS-ის გამოყენებით JSON-ის გამოყენებით

ყველა ცნობის ისტორია, რომელიც ID, გაგზავნა, კოდი, ტექსტი და ქვეყნიერება, მსახურებისა და მომზადებელი მონაცემების შესახებ.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.
`id`*	integer	ID თქვენი სათამაშო, მიიღო, როდესაც ტელეფონი გაიმართა.

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getSmsFull.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა sms[].ID გამოიყენება მხოლოდ ახალი წერილობით.
Numeric status SMScash: 1 - active, 6 - completed, 8 - cancelled or expired. status_name აირჩიეთ მოწყობილობები, მიიღეთ, გაკეთებული, გაკეთებული, გაკეთებული.
გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა REST /activations/{id}/sms with after_id.
რამდენიმე წუთის წინ, არასოდეს SMS გამოქვეყნებული იყო, getStatus და getSms Return (გამარჯვება) STATUS_CANCEL; getSmsFull გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა sms სურათები . REST /activations/{id} და /sms Return (გამარჯვება) 404 NO_ACTIVATION.

GETgetSmsSMS-ის გამოყენებით ტექნოლოგიური სისტემა

სრული SMS ისტორია დაბრუნდება მატერიალური კლიენტების ფორმატებით.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.
`id`*	integer	ID თქვენი სათამაშო, მიიღო, როდესაც ტელეფონი გაიმართა.

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getSms.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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

გამოგზავნილია: May ,

STATUS_WAIT_CODE

Cancellation ან მოწყობილობები

STATUS_CANCEL

შეტყობინება ფორმატი: time ±code ±text. რამდენიმე ცნობები ხელმძღვანელობენ.
SMS-ის თვითმმართველობის სისტემა შეგიძლიათ გამოიყენოთ კორპუსები და დრამა. უსაფრთხოების გაკეთება, გამოიყენეთ getSmsFull.

GETgetServicesსერვისები

Available service codes. პასუხი არის უზრუნველყოფს API Key-ის საფუძველი.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.
`country`	integer	მიიღეთ ID Mადლობა getCountries.

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getServices.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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, სახელები და ტელეფონები ქვეყანაში საინტერესო კორპუსში.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getCountries.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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პროექტის წევრები

ხელმისაწვდომი ოპერატორები: API ID, სახელი და ანაზღაურების შეჩერების ვადა.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.
`country`	integer	მიიღეთ ID Mადლობა getCountries.
`operator`	string	მიიღეთ ID Mადლობა operators/getOperators (API). `operator=1 · any/0`

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getOperators.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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 Mადლობა operators/getOperators (API).

GETgetRewardsSMS-ის გამოყენებით

ფასები აშშ-ის მდგომარეობაში. ყველა ფასდაკლების ფასდაკლება ფასდაკლების SMS-ზე.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.
`country`	integer	მიიღეთ ID Mადლობა getCountries.
`service`	string	Available service codes. პასუხი არის უზრუნველყოფს API Key-ის საფუძველი.
`operator`	string	მიიღეთ ID Mადლობა operators/getOperators (API). `operator=1 · any/0`

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getRewards.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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 ათობითი ადგილი:
გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა
country ID → service code → operator ID → reward (USD)

GETgetBalanceმომხმარებლის ბალანსი

Addition SMScash: ბრალდებული ბრალდებით, რადგან გაკეთება, განხორციელების ბრალდებით და ფასდაკლების მოთხოვნებს.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getBalance.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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 მიღების შემდეგ შემოსავალი ყოვნდება მომწოდებლის მიერ დადგენილი ვადით. მითითებულ დღეს თანხა ავტომატურად ხდება ხელმისაწვდომი გასატანად.

Parameters

Parameter სარეცხი	Type-ის გამოყენებით	აღწერა
`api_key`*	string	მომხმარებლის პირადი API გასაღები.

* მოთხოვნილი ფუნქცია. ყველა მოთხოვნილებით ასევე მოთხოვნილია მოთხოვნილება=getHoldBalance.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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 თუ წარმატებით; შეცდომა ყოველთვის ტექსტია.

Code რეგისტრაცია	HTTP	გამოცდილება და შემდეგი პასუხი
`TARIFF_NOT_CONFIGURED`	200	ფასდაკლების მიღება არ ჩაწერილასაათის განმავლობაში მოწყობილობები დაიწყო SMS გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა
`COUNTRY_BLOCKED`	200	გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტაშეგიძლიათ გააკეთოთ სხვა ქვეყანას.
`BAD_SERVICE`	200	გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტაშეგიძლიათ გააკეთოთ სხვა სისტემა.
`PROVIDER_NOT_READY`	200	გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტაAPI კორპუსები გაკეთება.
`BAD_KEY`	400	არა api_key არასწორი ფორმატი.შეგიძლიათ გამოიყუროთ მოწყობილობები მოწყობილობაში.
`INVALID_API_KEY`	401	Key არ იცვლება, არ ჩაწერილა ან Account disabled.შექმნილი ღირსეული API Key და
`BAD_COUNTRY`	400	არ არის ან არ არის საინტერესო ფასდაკლება.მიიღეთ ID Mადლობა getCountries.
`BAD_SESSION_DURATION`	400	ტელეფონები გაიმართება მხოლოდ 20 წუთის განმავლობაში.პასუხი session_duration.
`BAD_REQUEST`	400	არასწორი პარამეტრი Idempotency-Key.Please correct your request (გამარჯვებული თქვენი მოთხოვნით)
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Unknown or disabled რეგისტრაციის საფუძველი.API კორპუსები გაკეთება.
`BAD_NUMBER`	200	არასოდეს გაკეთებული ტექნოლოგიური სისტემა.გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა
`BAD_ACTION / BAD_STATUS`	200	Unknown Command, ID ან ტექნოლოგიური პროგრამა.შეგიძლიათ გამოიყუროთ სურათები.
`EMPTY_POOL`	200	არ არსებობს მოდელი ტელეფონები ამ დროისთვის.ორგანიზაცია 10-30 -სკენ ან ფილტრების შეცვლა.
`NUMBER_IN_USE`	200	აქტიური სექსიის თანახმად, განსაკუთრებული რაოდენობაა.შეასრულეთ თქვენი სათამაშო ან შეგიძლიათ გააკეთოთ სხვა სათამაშო სათამაშო.
`NO_ACTIVATION`	200	Session ან previous number არ არის თქვენი ანგარიშში.ID და Key-ის გამოყენებით.
`SESSION_CLOSED / SMS_REQUIRED`	200	დღეს არსებობს მდგომარეობა.შეგიძლიათ გააკეთოთ SMS-ის გამოყენებით და გამოყენებით.
`SCOPE_BLOCKED`	200	მსახურება, ქვეყნიერება ან ხელმძღვანელობა არ არის პასუხისმგებლობა.Update API Key-ის განმავლობაში.
`IDEMPOTENCY_CONFLICT`	200	ამ კითხვის გასაღები უკვე სხვა პარამეტრებთანა დაკავშირებულია.ახალი პრობლემისათვის, შეგიძლიათ გააკეთოთ სხვა Idempotency-Key.
`BAD_REF / SELF_REF`	400	პროგრამის კოდი არ არის უცნობი, ურთიერთობა ან საკუთარ თავს პასუხისმგებლობა.გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა
`INTERNAL_ERROR`	500	დროთა განმავლობაში სერვერი ან მოქმედებელი შეცდომა.პარამეტრები და იგივე Idempotency-Key.
`ALLOCATION_PENDING`	200	გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა Idempotency-Key.გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა 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.

New Integrations-ის გამოყენებით

USD ტარიფიული მნიშვნელოვანი ზუსტად ათასწლეული ტერიტორია დაბრუნდება 8 ათობითი ადგილი: 0.00300000 USD.

ბანუზმის გამუდმებით USD არის. მოთხოვნილებები და პასუხის სქემაები შეუძლებელია OpenAPI.

გამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა 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=1number available რეგისტრაციის

POST/api/v1/activationsNew Session (ქართულად) ახალი საათი

GET/api/v1/activations/batch?ids=42,43რამდენიმე ნომრის შემოწმება

GET/api/v1/activationsუკანასკნელი 200 სესიონი: scape=history, ლოცვა ან ყველა

GET/api/v1/activations/{id}Session და განცხადებები

GET/api/v1/activations/{id}/sms?after_id=0&limit=100SMS-ის გამოყენებით Cursor-ის გამოყენებით

POST/api/v1/activations/{id}/retrySMS-ის გამოყენებით

POST/api/v1/activations/{id}/finishშეფასება

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

POST/api/v1/activations/repeatnumber მოწყობილობები

GET/api/v1/keysAPI მოწყობილობები

POST/api/v1/keysგასაღები შექმნა

PATCH/api/v1/keys/{id}Name or Policy (ქართულად) / სახელი ან ტექნოლოგიის ფარგლებში

DELETE/api/v1/keys/{id}Key მოწყობილობები

GET/api/v1/referralsპასუხი: პასუხი და ფასდაკლება

GET/api/v1/summaryBalance და Summary

GET/api/v1/balanceდაკავებული თანხა

GET/api/v1/ledgerLEDGER ფასი

GET/api/v1/withdrawalsPayment მოთხოვნები

POST/api/v1/withdrawalsგამოგზავნილია: May , # · პროფილი · პირადი მიმოწერა · ჩატი · ელფოსტა

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
}

Save next_cursor and pass it on as after_id. If has_more=true, the next page can be read immediately. limit: 1–200. Sessions and SMS are available only to the owner. თუ გაქვთ_more=true, შემდეგი გვერდი შეგიძლიათ გააკეთოთ ახლა.