Att börja

API dokumentation

Antal, meddelanden och intäkter, direkt från din app.

GET

Börja med ett begäran

13 · API kommandonREST + handler_api.phpJSON / plain text · Bearer

Skapa en API-nyckel i din dashboard, få ett nummer och kolla in meddelanden var 20 sekunder.Payment krediteras när en SMS med en kod anländer; läs den igen påverkar inte din balans.

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

Kompatibilitet API bas URLhttps://smscash.org/stubs/handler_api.php

Service är levandetelefonnummer är, SMS och intäkter är tillgängliga. uttag är tillgängligt i USDT på TRC20Betalningar tar mellan 1 och 45 dagar .

Snabb start · 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}'

Alternativt kompatibelt gränssnitt: /handler_api.php. befintliga REST-integrationer fortsätter att fungera.

REST API

Skapa förfrågningar

cURL · Go · JS · Python

begärantjänst APILandet APIOperatör operatorProgramvara ägare kod refIdempotency-Key

Idempotency-Key: UUID · POST · 8–128

Automatiskt val: flest koder den senaste timmen, sedan 24 timmar. Inga nummer: nästa operatör.

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 Nyckel

Nyckeln sparas inte. Denna kontroll tilldelar inga nummer.

Rester för nya integrationer

Tjänster och länder

Välj en tjänst och land. Betalning via SMS beror på landet.

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)

Få ett nummer

REST

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

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

Automatiskt val: flest koder den senaste timmen, sedan 24 timmar. Inga nummer: nästa operatör.

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

Antalet är giltigt i 20 minuter. SMS kontrolleras var 20 sekunder. Du kan avbryta omedelbart.

Kontrollera flera nummer

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

Saldo · Reserverat

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 — Tillgängligt; held_balance — Reserverat. USD · 8

Du kan bara ta ut pengar vars väntetid har löpt ut.

Färdiga klienter

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

HeroSMS · Kompatibilitet API bas URLhttps://smscash.org/hero-sms/stubs/handler_api.php

Användarens personliga API-nyckel.

Välj en tjänst och land. Betalning via SMS beror på landet.

koden	Beskrivning
`getNumber / getNumberV2`	Få ett nummer
`getStatus / getStatusV2`	Få den senaste koden
`setStatus / finishActivation / cancelActivation`	Förvaltning session
`getPrices / getNumbersStatus`	Kontrollera tillgänglighet
`getRewards (SMScash)`	Belöning för SMS
`getServicesList / getServices`	Tjänster
`getCountries / getOperators`	Tjänster och länder
`getActiveActivations`	Sessioner
`getBalance`	Användarsaldo
`getHoldBalance (SMScash)`	Reserverat

cost = 0 USD · activationCost = 0 USD
reward — Belöning för 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'

Svar

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

Antalet är giltigt i 20 minuter. SMS kontrolleras var 20 sekunder. Du kan avbryta omedelbart.

Autentisering och returer

REST: header Authorization: Bearer YOUR_API_KEY. Kompatibel gränssnitt: Parameter api_key och actionAnvänd HTTPS.

För att hantera API-nycklar, logga in ditt konto.

∞Förfrågan/min per konto

∞samtidigt möten

API-förfrågan frekvens och antalet telefonnummer är obegränsade. Det finns inga dagliga eller timmars kvoter.

Antalet är giltigt i 20 minuter. SMS kontrolleras var 20 sekunder. Du kan avbryta omedelbart.

I övrigt, en unik Idempotency-Key Det är valfritt men rekommenderas i handler_api.php. Återanvänd nyckeln när du återvänder en nätverksansökan; Använd en ny ny nyckel för en ny operation.

API nyckelområde

Du kan begränsa en nyckel till specifika tjänster, länder och leverantörer. tomma listor tillåter alla tillgängliga alternativ.

JSON

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

PATCH /api/v1/keys/{id} ändrar namnet och policyn helt. hemligheten visas endast när den skapades.

10% i totalt. 5% + 5% med programkod.

När du utfärdar ett nummer, vänligen ge ref ägaren av programvaran. begäran är auktoriserad av exekutivnyckeln. koden finns i avsnittet "Referrals" och i GET /api/v1/referrals → software_ref.

begäran	Inbjudan	Programvara
Utan ref	10%	—
Med ref	5%	5%
Med ref, ingen referrer	—	5%

Plattformen betalar bonusen utan att minska användarens intäkter. programvaruägare och referensgivare kan vara samma person.

Termerna är fixerade när en session skapas; läs SMS och återkallande ändrar inte dem. Pass ref igen för en ny upprepade session. I avgiftsberäkningen ger en användares belöning av USD 0.003 USD 0.00015 var och en till programvaruägare och referrer. Den totala bonusen är USD 0.00030.

API kommandon

11 XVBC-stilmetoder plus din SMScash-balans.

GETgetNumberFå ett nummer

Skapa en session och reserverar ett tillgängligt nummer för användaren. belöningsraten och referensmottagarna är fasta vid tilldelning; belöningen krediteras när en SMS med kod anländer.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.
`service`*	string	Tillgängliga servicekoder. Svaret är begränsat till API-nyckeln.
`country`*	integer	Ta ID från getCountries.
`operator`	string	Ta ID från operators/getOperators (API). `operator=1 · any/0`
`session_duration`	integer	Sessionen varar 20 minuter. pass 20 eller missar denna parameter.
`with_operator`	integer	1 lägger till operatörens ID i svaret; 0 eller utelämnad parameter ger tre delar.
`ref`	string	Public kod av programvaruägare: 5% för honom och 5% för gästen. utan ref - 10% till den inbjudande.

* Det krävs parameter. i alla begäranden passerar även åtgärd=getNumber.

Exempelförfrågan

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)

Svar

Antal utfärdat

ACCESS_NUMBER:42:380670000000:1

Inga tillgängliga siffror

EMPTY_POOL

Automatiskt val: flest koder den senaste timmen, sedan 24 timmar. Inga nummer: nästa operatör.
Pass Idempotency-Key: samma begäran med samma nyckel returnerar den föregående sessionen. Ändrar parametrarna IDEMPOTENCY_CONFLICT.
Ett numeriskt land utan pool ger EMPTY_POOL; det felaktiga landformatet är BAD_COUNTRY.
Nyckeln till en raderad session används fortfarande: återspeglar tilldelningen med den nyckeln returnerar SESSION_CLOSED och utfärdar inte ett annat nummer.
Det automatiska uttaget är inaktiverat för att undvika att tilldela ett andra nummer.

GETgetNumbersStatusKontrollera tillgänglighet

Tillgängliga telefonnummer per service och land.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.
`country`*	integer	Ta ID från getCountries.

* Det krävs parameter. i alla begäranden passerar även åtgärd=getNumbersStatus.

Exempelförfrågan

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

Svar

Tillgängliga siffror

{
  "go_0": 0
}

_0 suffix betyder ett val utan en specifik operatör.
Tillgänglighet hänvisar till leverantörens totala pool. Den valda kanalen kontrolleras när ett nummer tilldelas.

GETgetStatusFå den senaste koden

Enkel begäran om sessionstatus och sista SMS-kod. Ledande zeros i koden bevaras.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.
`id`*	integer	ID av din session, som erhålls när numret utfärdades.

* Det krävs parameter. i alla begäranden passerar även åtgärd=getStatus.

Exempelförfrågan

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)

Svar

Väntar

STATUS_WAIT_CODE

Koden som mottagits

STATUS_OK:001234

Annullering eller utgång

STATUS_CANCEL

inte hittat

NO_ACTIVATION

Poll varje 20 sekunder.Läsning av ett meddelande igen skapar inte en annan betalning.
Efter återkallande returneras inte den gamla koden: getStatus väntar på nästa SMS.
Efter ett antal utan SMS är borttagna, getStatus och getSms återvända STATUS_CANCEL; getSmsFull returnerar stängd status, en tom telefon och en tom sms och listan. REST /activations/{id} och /sms återvända 404 NO_ACTIVATION.

GETsetStatusFörvaltning session

Slutar, avbryter eller återställer väntan på SMS. Sessionen löper ut förblir densamma.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.
`id`*	integer	ID av din session, som erhålls när numret utfärdades.
`status`*	integer	3 - vänta på nästa kod utan att förlänga sessionen; 6 - slut efter SMS; 8 - avbryta omedelbart.

* Det krävs parameter. i alla begäranden passerar även åtgärd=setStatus.

Exempelförfrågan

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)

Svar

Väntar på SMS

ACCESS_RETRY_GET

avslutad

ACCESS_ACTIVATION

Avbruten

ACCESS_CANCEL

Retry väntar på nästa kod inom de ursprungliga 20 minuter. utgången och utgångstiderna ändras inte.
För status =3 Användning Idempotency-KeyUpprepa begäran kommer inte att återställa den nya koden som redan erhållits. SMS förblir tillgängliga.
Annullering tar inte bort redan erhållna belöningar.
Endast siffror med en SMS-kod sparas i historien. Annullerade och utgångsrika siffror utan kod raderas.

GETgetRepeatNumberFår samma nummer igen

Öppna en ny session med ett specifikt nummer från din historia. Du kan välja en annan tillgänglig tjänst i samma land.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.
`number`*	string	Endast siffror och en valfri ledare + är tillåten.
`service`*	string	Tillgängliga servicekoder. Svaret är begränsat till API-nyckeln.
`session_duration`	integer	Sessionen varar 20 minuter. pass 20 eller missar denna parameter.
`with_operator`	integer	1 lägger till operatörens ID i svaret; 0 eller utelämnad parameter ger tre delar.
`ref`	string	Public kod av programvaruägare: 5% för honom och 5% för gästen. utan ref - 10% till den inbjudande.
`operator`	string	Ta ID från operators/getOperators (API). `operator=1 · any/0`

* Det krävs parameter. i alla begäranden passerar även åtgärd=getRepeatNumber.

Exempelförfrågan

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)

Svar

Ny session

ACCESS_NUMBER:43:380670000000

Antalet är fortfarande upptagen

NUMBER_IN_USE

Först avsluta eller avbryta din nuvarande session. Om numret är upptagen, uttag inte utförs.
Den nya sessionen får ett nytt ID och den aktuella tariff. Gamla SMS kopieras inte in i den. ref ställs in igen.
SMScash tillåter att endast siffror upprepas från kontothistorien.
Nyckeln till en raderad session används fortfarande: återspeglar tilldelningen med den nyckeln returnerar SESSION_CLOSED och utfärdar inte ett annat nummer.

GETgetSmsFullFå SMS som JSON

Strukturerad historia av alla meddelanden med ID, avsändare, kod, text och land, service och leverantör data.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.
`id`*	integer	ID av din session, som erhålls när numret utfärdades.

* Det krävs parameter. i alla begäranden passerar även åtgärd=getSmsFull.

Exempelförfrågan

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

Svar

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

Företrädesformat för integration. Kom ihåg sms[].id för att endast behandla nya meddelanden.
Numerisk status SMScash: 1 - aktiv, 6 - fullbordad, 8 - avbeställd eller utgångstid. status_name skiljer mellan väntar, mottagit, slutfört, avbeställd, utgångstid.
De mottagna koderna förblir tillgängliga efter en session stängs. För stora volymer, använd REST /activations/{id}/sms med after_id.
Efter ett antal utan SMS är borttagna, getStatus och getSms återvända STATUS_CANCEL; getSmsFull returnerar stängd status, en tom telefon och en tom sms och listan. REST /activations/{id} och /sms återvända 404 NO_ACTIVATION.

GETgetSmsFå SMS som textsträng

Returnerar hela SMS-historien i strängformat för befintliga kunder.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.
`id`*	integer	ID av din session, som erhålls när numret utfärdades.

* Det krävs parameter. i alla begäranden passerar även åtgärd=getSms.

Exempelförfrågan

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)

Svar

Meddelande

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

Väntar

STATUS_WAIT_CODE

Annullering eller utgång

STATUS_CANCEL

Meddelande format: tidssnittskod text.Många meddelanden är separerade av en kolumn.
Text SMS kan innehålla kolumner och vertikala rader. För tillförlitlig parsing, använd getSmsFull.

GETgetServicesTjänster

Tillgängliga servicekoder. Svaret är begränsat till API-nyckeln.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.
`country`	integer	Ta ID från getCountries.

* Det krävs parameter. i alla begäranden passerar även åtgärd=getServices.

Exempelförfrågan

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

Svar

Tjänster

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

Servicedirektorn delas över leverantören. nummer tillgänglighet kontrolleras separat.

GETgetCountriesLänder

ID, namn och samtalskoder för länder i den valda kanalen.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.

* Det krävs parameter. i alla begäranden passerar även åtgärd=getCountries.

Exempelförfrågan

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

Svar

Länder

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

GETgetOperatorsOperatörer

Tillgängliga operatörer: API-ID, namn och innehållningsperiod.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.
`country`	integer	Ta ID från getCountries.
`operator`	string	Ta ID från operators/getOperators (API). `operator=1 · any/0`

* Det krävs parameter. i alla begäranden passerar även åtgärd=getOperators.

Exempelförfrågan

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

Svar

Operatörer

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

Ta ID från operators/getOperators (API).

GETgetRewardsBelöning för SMS

Räntor beror på landet. Alla tabellbelopp är per betald SMS.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.
`country`	integer	Ta ID från getCountries.
`service`	string	Tillgängliga servicekoder. Svaret är begränsat till API-nyckeln.
`operator`	string	Ta ID från operators/getOperators (API). `operator=1 · any/0`

* Det krävs parameter. i alla begäranden passerar även åtgärd=getRewards.

Exempelförfrågan

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

Svar

JSON

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

{}

{}

USD-tariffbelopp returneras som exakta decimalsträngar med 8 decimal platser:
Tillåtna leverantörer tillgängliga för din nyckel.
country ID → service code → operator ID → reward (USD)

GETgetBalanceAnvändarsaldo

SMScash: tillgänglig balans med hänsyn till akrualer, referensbonusar och betalningsförfrågningar.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.

* Det krävs parameter. i alla begäranden passerar även åtgärd=getBalance.

Exempelförfrågan

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)

Svar

Saldo

ACCESS_BALANCE:0.00

getBalance returnerar den tillgängliga USD-balansen med upp till 8 decimal platser.
Du kan bara ta ut pengar vars väntetid har löpt ut.

GETgetHoldBalanceReserverat

När ett SMS har tagits emot hålls intäkterna inne under den tid som leverantören anger. På det angivna datumet blir beloppet automatiskt tillgängligt för uttag.

Parameter

Parameter	Typ	Beskrivning
`api_key`*	string	Användarens personliga API-nyckel.

* Det krävs parameter. i alla begäranden passerar även åtgärd=getHoldBalance.

Exempelförfrågan

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)

Svar

Reserverat

ACCESS_HOLD_BALANCE:34.50000001

SMScash · getHoldBalance · USD · 8
Du kan bara ta ut pengar vars väntetid har löpt ut.

Svarkoder och upprepade begäranden

In handler_api.fp affärsresultat kommer vanligtvis med HTTP 200. Kolla kroppstexten. kataloger och getSmsFull tillbaka JSON om framgångsrikt; fel är alltid text.

koden	HTTP	Orsak och nästa steg
`TARIFF_NOT_CONFIGURED`	200	Räntorna är ännu inte fastställdaAntal tilldelning börjar när SMS-priserna är konfigurerade.
`COUNTRY_BLOCKED`	200	Antal tilldelningar för detta land är blockerade.Välj ett annat land.
`BAD_SERVICE`	200	Antal tilldelning för denna tjänst är blockerat.Välj en annan tjänst.
`PROVIDER_NOT_READY`	200	Antal tilldelning är tillfälligt inte tillgängligtUppdatera API-katalogerna
`BAD_KEY`	400	Nej api_key eller ugyldig format.Kontrollera nyckeln i begäran.
`INVALID_API_KEY`	401	Nyckeln är okänd, återkallad eller kontot är inaktiverat.Skapa en giltig API-nyckel.
`BAD_COUNTRY`	400	Det är ett positivt nummer som saknas eller inte.Ta ID från getCountries.
`BAD_SESSION_DURATION`	400	Telefonnummer utfärdas i exakt 20 minuter.Korrekt session_duration.
`BAD_REQUEST`	400	Ugyldig parameter eller Idempotency-Key.Vänligen korrigera din begäran.
`BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER`	200	Okända eller funktionshindrade kataloger.Uppdatera API-katalogerna
`BAD_NUMBER`	200	felaktig antal format.Ange numret i siffror.
`BAD_ACTION / BAD_STATUS`	200	Okänd kommando, ID eller operation.Kolla in inställningarna.
`EMPTY_POOL`	200	Inga matchande telefonnummer finns för närvarande.Upprepa efter 10-30 sekunder eller ändra filter.
`NUMBER_IN_USE`	200	Ett specifikt nummer är besatt av en aktiv session.Avsluta sessionen eller välj ett annat nummer.
`NO_ACTIVATION`	200	Sessionen eller föregående nummer tillhör inte ditt konto.Kontrollera ID och nyckel.
`SESSION_CLOSED / SMS_REQUIRED`	200	Statsövergången är för närvarande inte tillgänglig.Kontrollera villkoren och tillgängligheten av SMS.
`SCOPE_BLOCKED`	200	Tjänsten, landet eller leverantören är inte auktoriserad för nyckeln.Uppdatera API-nyckeln.
`IDEMPOTENCY_CONFLICT`	200	Denna söknyckel är redan associerad med andra parametrar.För en ny operation, skapa en annan Idempotency-Key.
`BAD_REF / SELF_REF`	400	Programkoden är okänd, funktionshindrad eller tillhör användaren själv.Pass på programvaruägarens kod.
`INTERNAL_ERROR`	500	Tillfällig server eller leverantörsfel.Repeterar med en förseende och lika Idempotency-Key.
`ALLOCATION_PENDING`	200	Nummertildelning är redan i framstegen. Revise med samma Idempotency-Key.Nummertildelning är redan i framstegen. Revise med samma Idempotency-Key.
`ALLOCATION_UNCERTAIN`	200	Det automatiska uttaget är inaktiverat för att undvika att tilldela ett andra nummer.Det automatiska uttaget är inaktiverat för att undvika att tilldela ett andra nummer.

REST returnerar ett objekt {"error":{"code":"…","message":"…"}} och regelbundet HTTP statuser 400/401/403/404/409/503.

JSON

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Kolla in begäran fält.",
    "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.

Rester för nya integrationer

USD-tariffbelopp returneras som exakta decimalsträngar med 8 decimal platser: 0.00300000 USD.

Balansvärdet är USD. Begäran och svar scheman finns i OpenAPI.

Avdrag i USDT · TRC20Utbetalningar tar mellan 1 och 45 dagar. Uttagsavgiften är 4 $. Den dras från det begärda beloppet. När ett SMS har tagits emot hålls intäkterna inne under den tid som leverantören anger. På det angivna datumet blir beloppet automatiskt tillgängligt för uttag. Du kan bara ta ut pengar vars väntetid har löpt ut.

GET/api/v1/catalogTjänster och länder

GET/api/v1/tariffsSMS belöning priser per land

GET/api/v1/offersRäntor och belöningar

GET/api/v1/servicesDirektor

GET/api/v1/countriesDirektor

GET/api/v1/operatorsDirektor

GET/api/v1/availability?country=1Antal tillgänglighet

POST/api/v1/activationsNy session

GET/api/v1/activations/batch?ids=42,43Kontrollera flera nummer

GET/api/v1/activationsSenaste 200 sessioner: scope=history, väntar eller allt

GET/api/v1/activations/{id}Session och meddelanden

GET/api/v1/activations/{id}/sms?after_id=0&limit=100Ny SMS med kursor

POST/api/v1/activations/{id}/retryVäntar på SMS

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

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

POST/api/v1/activations/repeatAntal återvänder

GET/api/v1/keysAPI Nycklar

POST/api/v1/keysSkapa en nyckel

PATCH/api/v1/keys/{id}Ändra namn eller politik

DELETE/api/v1/keys/{id}Återkallande nyckel

GET/api/v1/referralsReferenskod och intäkter

GET/api/v1/summaryBalans och sammanfattning

GET/api/v1/balanceReserverat

GET/api/v1/ledgerFördelar Ledger

GET/api/v1/withdrawalsBetalningsförfrågningar

POST/api/v1/withdrawalsSkapa en begäran

GET/api/v1/statisticsAllmän statistik

GET/api/v1/earnings/holdsVäntetid för intäkter

Bara att få nya 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": "Kode: 001234",
      "sender": "Service",
      "received_at": "2026-10-09T12:00:00Z"
    }
  ],
  "next_cursor": 101,
  "has_more": false
}

Spara next_cursor och överlämna den som after_id. Även has_more=true, nästa sidan kan läsas omedelbart. gräns: 1–200. Sessioner och SMS Det finns endast tillgängligt för ägaren.