Tall, meldinger og inntekter, direkte fra appen din.
SMScash
API dokumentasjon
Å begynne

API dokumentasjon

Tall, meldinger og inntekter, direkte fra appen din.

Begynn med en forespørsel

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

Skap en API-nøkkel i dashboardet ditt, få et nummer og sjekk for meldinger hvert 20 sekunder.Payment er kreditt når en SMS med en kode ankommer; å lese den igjen påvirker ikke balanse.

REST APIhttps://smscash.org/api/v1
Kompatibilitet API base URLhttps://smscash.org/stubs/handler_api.php
Tjenesten er livetelefonnummeret er, SMS og inntekter er tilgjengelige. uttak er tilgjengelig i USDT På TRC20Betalinger tar mellom 1 og 45 Dagene er.
Snart 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}'

Alternativ kompatibel grensesnittadresse: /handler_api.php. eksisterende REST-integrasjoner fortsetter å fungere.

REST API

Lag forespørsler

cURL · Go · JS · Python

Idempotency-Key: UUID · POST · 8–128

Automatisk valg: flest koder siste time, deretter 24 timer. Ingen numre: neste 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}'

Nøkkelen lagres ikke. Denne kontrollen tildeler ingen numre.

Resten av nye integrasjoner

Tjenester og land

Velg en tjeneste og land. Betaling via SMS avhenger av 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å et nummer
REST
POST /api/v1/activations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: request-unique-001

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

Automatisk valg: flest koder siste time, deretter 24 timer. Ingen numre: neste 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

Tallet er gyldig i 20 minutter. SMS sjekkes hvert 20 sekunder. Du kan avbestille umiddelbart.

Kontroller flere numre
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 · Tilbakeholdt
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 — Tilgjengelig; held_balance — Tilbakeholdt. USD · 8

Bare penger med utløpt tilbakeholdelsesperiode kan tas ut.

Bruksklare klienter

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

Brukerens personlige API-nøkkel.

Velg en tjeneste og land. Betaling via SMS avhenger av landet.

KodekodeBeskrivelse
getNumber / getNumberV2Få et nummer
getStatus / getStatusV2Få den nyeste koden
setStatus / finishActivation / cancelActivationStyringssøkt
getPrices / getNumbersStatusSjekk tilgjengeligheten
getRewards (SMScash)Belønning for SMS
getServicesList / getServicesTjenester
getCountries / getOperatorsTjenester og land
getActiveActivationsSessjoner
getBalanceBrukersaldo
getHoldBalance (SMScash)Tilbakeholdt

cost = 0 USD · activationCost = 0 USD
reward — Belønning for 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.

Tallet er gyldig i 20 minutter. SMS sjekkes hvert 20 sekunder. Du kan avbestille umiddelbart.

Autentisering og returer

REST: header Authorization: Bearer YOUR_API_KEY. Kompatible grensesnitt: Parameter api_key og actionBruk HTTPS

For å administrere API-nøkler, skriv inn kontoen din.

∞Forespørsler/min per konto
∞Samtidig sesjon

API-forespørsler frekvens og antall telefonnummer er ubegrenset. Det er ingen daglig eller timevis kvoter.

Tallet er gyldig i 20 minutter. SMS sjekkes hvert 20 sekunder. Du kan avbestille umiddelbart.

I tillegg til en unik Idempotency-Key Det er valgfritt, men anbefales i handler_api.php. Åpne bruken av nøkkelen når du returer en nettverksforespørsel; Bruk en ny nøkkel for en ny operasjon.

API nøkkelområde

Du kan begrense en nøkkel til bestemte tjenester, land og leverandører. tomme lister tillater alle tilgjengelige alternativer.

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

PATCH /api/v1/keys/{id} Navnet og politikken endres helt. hemmeligheten vises bare når den er skapt.

10% i alt. 5% + 5% med programvare kode.

Når du gir et nummer, vennligst gi ref eieren av programvaren. forespørselen er godkjent av utføreren nøkkel. koden er i avsnittet "Referrals" og i GET /api/v1/referrals → software_ref.

ForespørselInvitererProgramvare
Uten ref10%—
Med ref5%5%
Med ref, ingen referrer—5%

Plattformen betaler bonusen uten å redusere brukers inntekter. programvaremaskiner og referrer kan være den samme personen.

Termer er fastsatt når en sesjon er opprettet; lesing SMS og tilbakemelding endrer ikke dem. Pass ref igjen for en ny gjentatt sesjon. I tariffberegningen gir en brukers belønning på USD 0.003 USD 0.00015 hver til programvaren eieren og referreren. Den totale bonusen er USD 0.00030.

API Kommandom

11 XVBC-stil metoder plus din SMScash-balans.

GETgetNumberFå et nummer

Oppsummering: Belønningsraten og referral mottaker er fastsatt ved tildeling; belønningen krediteres når en SMS med en kode ankommer.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.
service*stringTilgjengelige servicekoder. Svaret er begrenset til området for API-nøkkel.
country*integerTa ID fra getCountries.
operatorstringTa ID fra operators/getOperators (API). operator=1 · any/0
session_durationintegerSessionen varer 20 minutter. pass 20 eller unngå denne parameteren.
with_operatorinteger1 legger til operatørens ID i svaret; 0 eller utelatelse gir tre deler.
refstringOffentlig kode av programvaremaskinen: 5% For ham og 5% For gjestene - uten ref - 10% til gjestene.

* Forespørgsler: I alle forespørsler passer også handling = getNumber.

Eksempelforespørsel

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'

Svar

Antall utstedt
ACCESS_NUMBER:42:380670000000:1
Ingen tilgjengelige tall
EMPTY_POOL
  • Automatisk valg: flest koder siste time, deretter 24 timer. Ingen numre: neste operatør.
  • Pass Idempotency-Key: den samme anmodningen med samme nøkkel gir den forrige økta. Endrer parametrene samtaler IDEMPOTENCY_CONFLICT.
  • Et numerisk land uten basseng gir EMPTY_POOL; feil landformat er BAD_COUNTRY.
  • Nøkkel for en slettet sesjon forblir brukt: Å gjenopplive tildeling med den nøkkelen returnerer SESSION_CLOSED og utgir ikke et annet nummer.
  • Det automatiske tilbakemeldingen er inaktiv for å unngå å tildele et annet nummer.
GETgetNumbersStatusSjekk tilgjengeligheten

Tilgjengelige telefonnummer per tjeneste og land.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.
country*integerTa ID fra getCountries.

* Forespørgsler: I alle forespørsler passer også handling = getNumbersStatus.

Eksempelforespørsel

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getNumbersStatus&api_key=YOUR_API_KEY&country=86'

Svar

Tilgjengelige tall
{
  "go_0": 0
}
  • _0 suffix betyr et valg uten en bestemt operatør.
  • Tilgjengelighet refererer til leverandørens totale basseng. Den valgte kanalen sjekkes når et nummer er tildelt.
GETgetStatusFå den nyeste koden

Enkel forespørsel om sesjonsstatus og siste SMS-kode. ledende zeros i koden er bevaret.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.
id*integerID av sesjonen, mottatt når nummeret ble utstedt.

* Forespørgsler: I alle forespørsler passer også handling = getStatus.

Eksempelforespørsel

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getStatus&api_key=YOUR_API_KEY&id=42'

Svar

Venter
STATUS_WAIT_CODE
Kode mottatt
STATUS_OK:001234
Avbestillinger eller utløp
STATUS_CANCEL
Ikke funnet
NO_ACTIVATION
  • Poll hver 20 sekunder. Lesing av en melding igjen skaper ikke en annen betaling.
  • Etter retry den gamle koden ikke returneres: getStatus venter på neste SMS.
  • Etter et antall uten SMS er slettet, getStatus og getSms Tilbake STATUS_CANCEL; getSmsFull returnerer den lukkede status, en tom telefon og en tom sms og liste. REST /activations/{id} og /sms Tilbake 404 NO_ACTIVATION.
GETsetStatusStyringssøkt

Avslutter, avbryter eller gjenoppretter ventet på SMS. Sesjonen utløper forblir den samme.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.
id*integerID av sesjonen, mottatt når nummeret ble utstedt.
status*integer3 – vent på neste kode uten å forlenge sesjonen; 6 – avslutte etter SMS; 8 – avbestille umiddelbart.

* Forespørgsler: I alle forespørsler passer også handling = setStatus.

Eksempelforespørsel

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'

Svar

Venter på SMS
ACCESS_RETRY_GET
Kompletterte
ACCESS_ACTIVATION
Avbestilt
ACCESS_CANCEL
  • Retry venter på neste kode innen de opprinnelige 20 minutter. utløpet og utløpstider endrer seg ikke.
  • For status =3 Bruker Idempotency-Key: gjenta forespørselen vil ikke gjenopprette den nye koden som allerede er mottatt. SMS forblir tilgjengelig.
  • Annullering fjerner ikke belønningene som allerede er tjent.
  • Kun tall med en SMS-kode blir lagret i historien. Annullerte og utløpte tall uten kode blir slettet.
GETgetRepeatNumberSnakk igjen samme nummer

Åpne en ny sesjon med et spesifikt nummer fra din historie. Du kan velge en annen tilgjengelig tjeneste i samme land.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.
number*stringBare tall og en valgfri leder + er tillatt.
service*stringTilgjengelige servicekoder. Svaret er begrenset til området for API-nøkkel.
session_durationintegerSessionen varer 20 minutter. pass 20 eller unngå denne parameteren.
with_operatorinteger1 legger til operatørens ID i svaret; 0 eller utelatelse gir tre deler.
refstringOffentlig kode av programvaremaskinen: 5% For ham og 5% For gjestene - uten ref - 10% til gjestene.
operatorstringTa ID fra operators/getOperators (API). operator=1 · any/0

* Forespørgsler: I alle forespørsler passer også handling = getRepeatNumber.

Eksempelforespørsel

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'

Svar

Nytt møte
ACCESS_NUMBER:43:380670000000
Antallet er fortsatt opptatt
NUMBER_IN_USE
  • Først, avslutte eller avbestille din nåværende sesjon. Hvis tallet er opptatt, utføres ikke re-utsuksjon.
  • Den nye sesjonen mottar en ny ID og den nåværende tariff. gamle SMS er ikke kopiert inn i den. ref er satt igjen.
  • SMScash tillater å gjenta bare tall fra kontohistorien.
  • Nøkkel for en slettet sesjon forblir brukt: Å gjenopplive tildeling med den nøkkelen returnerer SESSION_CLOSED og utgir ikke et annet nummer.
GETgetSmsFullFå SMS som JSON

Strukturert historie av alle meldinger med ID, sender, kode, tekst og land, service og leverandør data.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.
id*integerID av sesjonen, mottatt når nummeret ble utstedt.

* Forespørgsler: I alle forespørsler passer også handling = getSmsFull.

Eksempelforespørsel

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getSmsFull&api_key=YOUR_API_KEY&id=42'

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"
}
  • Foretrukket format for integrasjon. Husk sms[].id for å bare behandle nye meldinger.
  • Numerisk status SMScash: 1 - aktiv, 6 - fullført, 8 - kansellert eller utløpt. status_name skiller mellom ventet, mottatt, ferdig, kansellert, utløpt.
  • Mottatte koder fortsatt tilgjengelige etter en økt lukker. Bruk for store volumer REST /activations/{id}/sms med after_id.
  • Etter et antall uten SMS er slettet, getStatus og getSms Tilbake STATUS_CANCEL; getSmsFull returnerer den lukkede status, en tom telefon og en tom sms og liste. REST /activations/{id} og /sms Tilbake 404 NO_ACTIVATION.
GETgetSmsFå SMS som tekststreng

Returnerer hele SMS-historien i strikkformatet for eksisterende kunder.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.
id*integerID av sesjonen, mottatt når nummeret ble utstedt.

* Forespørgsler: I alle forespørsler passer også handling = getSms.

Eksempelforespørsel

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getSms&api_key=YOUR_API_KEY&id=42'

Svar

Melding
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234
Venter
STATUS_WAIT_CODE
Avbestillinger eller utløp
STATUS_CANCEL
  • Meddelelsesformat: time-kode, tekst. Flere meldinger er skilt av en kolonne.
  • Tekst SMS kan inneholde kolonner og vertikale barer. for pålitelig parsing, bruk getSmsFull.
GETgetServicesTjenester

Tilgjengelige servicekoder. Svaret er begrenset til området for API-nøkkel.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.
countryintegerTa ID fra getCountries.

* Forespørgsler: I alle forespørsler passer også handling = getServices.

Eksempelforespørsel

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getServices&api_key=YOUR_API_KEY'

Svar

Tjenester
{
  "go": {
    "name": "Google",
    "code": "go"
  }
}
  • Tjenestedialogen deles over leverandøren.Numret tilgjengelighet sjekkes separat.
GETgetCountriesLand

ID, navn og ringer koder for land i den valgte kanalen.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.

* Forespørgsler: I alle forespørsler passer også handling = getCountries.

Eksempelforespørsel

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getCountries&api_key=YOUR_API_KEY'

Svar

Land
{
  "86": {
    "id": 86,
    "name": "Italy",
    "phone_code": "39"
  }
}
GETgetOperatorsOperatører

Tilgjengelige operatører: API-ID, navn og tilbakeholdelsesperiode.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.
countryintegerTa ID fra getCountries.
operatorstringTa ID fra operators/getOperators (API). operator=1 · any/0

* Forespørgsler: I alle forespørsler passer også handling = getOperators.

Eksempelforespørsel

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getOperators&api_key=YOUR_API_KEY'

Svar

Operatører
{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}
  • Ta ID fra operators/getOperators (API).
GETgetRewardsBelønning for SMS

Rates avhenger av landet.Alle tabellbeløp er per betalt SMS.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.
countryintegerTa ID fra getCountries.
servicestringTilgjengelige servicekoder. Svaret er begrenset til området for API-nøkkel.
operatorstringTa ID fra operators/getOperators (API). operator=1 · any/0

* Forespørgsler: I alle forespørsler passer også handling = getRewards.

Eksempelforespørsel

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getRewards&api_key=YOUR_API_KEY&country=59&service=vi'

Svar

JSON
{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}
{}
{}
  • USD-tariffbeløp returneres som nøyaktige tiende strenger med 8 tiende plasser:
  • Tilgjengelige leverandører til din nøkkel.
  • country ID → service code → operator ID → reward (USD)
GETgetBalanceBrukersaldo

Additional SMScash: tilgjengelig balanse med hensyn til akrualer, referral bonuser og betalingssøkelser.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.

* Forespørgsler: I alle forespørsler passer også handling = getBalance.

Eksempelforespørsel

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getBalance&api_key=YOUR_API_KEY'

Svar

Saldo
ACCESS_BALANCE:0.00
  • getBalance returnerer den tilgjengelige USD-balansen med opptil 8 decimal poeng.
  • Bare penger med utløpt tilbakeholdelsesperiode kan tas ut.
GETgetHoldBalanceTilbakeholdt

Etter at et SMS er mottatt, holdes inntektene tilbake i perioden leverandøren har fastsatt. På den angitte datoen blir beløpet automatisk tilgjengelig for uttak.

Parameter

ParameterTypeBeskrivelse
api_key*stringBrukerens personlige API-nøkkel.

* Forespørgsler: I alle forespørsler passer også handling = getHoldBalance.

Eksempelforespørsel

curl
curl 'https://smscash.org/stubs/handler_api.php?action=getHoldBalance&api_key=YOUR_API_KEY'

Svar

Tilbakeholdt
ACCESS_HOLD_BALANCE:34.50000001
  • SMScash · getHoldBalance · USD · 8
  • Bare penger med utløpt tilbakeholdelsesperiode kan tas ut.

Svarkoder og gjentatte forespørsler

Inn handler_api.php virksomhetsresultater kommer vanligvis med HTTP 200. Sjekk kroppens tekst. mapper og getSmsFull tilbake JSON dersom det er vellykket; feil er alltid tekst.

KodekodeHTTPÅrsak og neste trinn
TARIFF_NOT_CONFIGURED200Renter er ennå ikke sattTallfordeling vil begynne når SMS-belønninger er konfigurert.
COUNTRY_BLOCKED200Antall tildeling for dette landet er blokkert.Velg et annet land.
BAD_SERVICE200Antall tildelinger for denne tjenesten er blokkert.Velg en annen tjeneste.
PROVIDER_NOT_READY200Antall tildelinger er midlertidig utilgjengeligeOppdaterer API-katalogene
BAD_KEY400Nei api_key eller ugyldig format.Sjekk nøkkelen i forespørselen.
INVALID_API_KEY401Nøkkel er ukjent, avlyst eller kontoen er deaktivert.Skap en gyldig API-nøkkel.
BAD_COUNTRY400Det er et positivt nummer som mangler eller ikke.Ta ID fra getCountries.
BAD_SESSION_DURATION400Telefonnummerene blir utstedt i nøyaktig 20 minutter.Korrekt session_duration.
BAD_REQUEST400Invalid parameter eller Idempotency-Key.Vennligst rette opp forespørselen din.
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER200ukjent eller funksjonelt katalog.Oppdaterer API-katalogene
BAD_NUMBER200feil nummer format.Skriv inn tallet i tall.
BAD_ACTION / BAD_STATUS200ukjent kommando, ID eller operasjon.Sjekk innstillingene.
EMPTY_POOL200Ingen matchende telefonnummer er for øyeblikket tilgjengelig.Gjenta etter 10-30 sekunder eller endre filter.
NUMBER_IN_USE200Et bestemt nummer er opptatt av en aktiv sesjon.Avslutt sesjonen eller velg et annet nummer.
NO_ACTIVATION200Session eller tidligere nummer tilhører ikke kontoen din.Sjekk ID og nøkkel.
SESSION_CLOSED / SMS_REQUIRED200Den statlige overgangen er for øyeblikket ikke tilgjengelig.Sjekk ut tilstanden og tilgjengeligheten av SMS.
SCOPE_BLOCKED200Tjenesten, landet eller leverandøren er ikke autorisert for nøkkelen.Oppdaterer API-nøkkelens rekkevidde.
IDEMPOTENCY_CONFLICT200Denne spørreklappen er allerede forbundet med andre parametere.For en ny operasjon, opprette en annen Idempotency-Key.
BAD_REF / SELF_REF400Programvarekoden er ukjent, funksjonshemmede eller tilhører brukeren selv.Pass på programvaremaskinens kode.
INTERNAL_ERROR500Tilfeldig server eller leverandør feil.Gjenta med en forsinkelse og den samme Idempotency-Key.
ALLOCATION_PENDING200Talltildeling er allerede i gang. Prøv på nytt med det samme Idempotency-Key.Talltildeling er allerede i gang. Prøv på nytt med det samme Idempotency-Key.
ALLOCATION_UNCERTAIN200Det automatiske tilbakemeldingen er inaktiv for å unngå å tildele et annet nummer.Det automatiske tilbakemeldingen er inaktiv for å unngå å tildele et annet nummer.

Resten returnerer et objekt {"error":{"code":"…","message":"…"}} og vanlige HTTP-statuser 400/401/403/404/409/503.

JSON
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Sjekk forespørsler om felt.",
    "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.

Resten av nye integrasjoner

USD-tariffbeløp returneres som nøyaktige tiende strenger med 8 tiende plasser: 0.00300000 USD.

Valutaen er USD. Forespørsler og svar ordninger er tilgjengelige i OpenAPI.

Avdrag i USDT · TRC20Utbetalinger tar mellom 1 og 45 dager. Uttaksgebyret er 4 $. Det trekkes fra det forespurte beløpet. Etter at et SMS er mottatt, holdes inntektene tilbake i perioden leverandøren har fastsatt. På den angitte datoen blir beløpet automatisk tilgjengelig for uttak. Bare penger med utløpt tilbakeholdelsesperiode kan tas ut.
GET/api/v1/catalogTjenester og land
GET/api/v1/tariffsSMS belønningstider per land
GET/api/v1/offersPris og belønning
GET/api/v1/servicesDirektor
GET/api/v1/countriesDirektor
GET/api/v1/operatorsDirektor
GET/api/v1/availability?country=1Numbers tilgjengelighet
POST/api/v1/activationsNytt møte
GET/api/v1/activations/batch?ids=42,43Kontroller flere numre
GET/api/v1/activationsSiste 200 sesjoner: scope=history, vent eller alt
GET/api/v1/activations/{id}Session og budskap
GET/api/v1/activations/{id}/sms?after_id=0&limit=100Nytt SMS med kursor
POST/api/v1/activations/{id}/retryVenter på SMS
POST/api/v1/activations/{id}/finishKomplett
POST/api/v1/activations/{id}/cancelAvbestillinger
POST/api/v1/activations/repeatAntall reiser
GET/api/v1/keysAPI Nøkkel
POST/api/v1/keysSkap en nøkkel
PATCH/api/v1/keys/{id}Endre navn eller politikk
DELETE/api/v1/keys/{id}Avbryt nøkkelen
GET/api/v1/referralsReferral kode og fortjeneste
GET/api/v1/summaryBalanse og sammendrag
GET/api/v1/balanceTilbakeholdt
GET/api/v1/ledgerEgenskap Ledger
GET/api/v1/withdrawalsBetalingsforespørsler
POST/api/v1/withdrawalsSkap en forespørsel
GET/api/v1/statisticsAllmenn statistikk
GET/api/v1/earnings/holdsTilbakeholdelse av inntekter

Bare nye SMS-er

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
}

Lagre next_cursor og send den på som after_id. Hvis has_more=true, neste side kan leses umiddelbart. grense: 1–200. Økter og SMS er tilgjengelig bare for eieren.