Nummers, berichten en inkomsten, rechtstreeks van uw app.
SMScash
API documentatie
te beginnen

API documentatie

Nummers, berichten en inkomsten, rechtstreeks van uw app.

Begin met één verzoek

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

Creëer een API-toets in je dashboard, krijg een nummer en controleer elke 20 seconden voor berichten.Payment is gecrediteerd wanneer een SMS met een code aankomt; het lezen ervan opnieuw beïnvloedt uw balans niet.

REST APIhttps://smscash.org/api/v1
Compatibiliteit API basis URLhttps://smscash.org/stubs/handler_api.php
De dienst is levendTelefoonnummers , SMS en de inkomsten zijn beschikbaar. aftrekken zijn beschikbaar in USDT op TRC20Betalingen nemen tussen 1 en 45 De dagen.
Snelle 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}'

Alternatieve compatibele interface adres: /handler_api.php. bestaande REST-integraties blijven werken.

REST API

Verzoekgenerator

cURL · Go · JS · Python

Idempotency-Key: UUID · POST · 8–128

Automatische keuze: de meeste codes in het afgelopen uur, daarna 24 uur. Geen nummers: volgende operator.

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

De sleutel wordt niet opgeslagen. Deze controle geeft geen nummers uit.

De rest van nieuwe integraties

Diensten en landen

Kies een service en land. Betaling per SMS hangt af van het land.

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)

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

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

Automatische keuze: de meeste codes in het afgelopen uur, daarna 24 uur. Geen nummers: volgende operator.

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

Het nummer is geldig voor 20 minuten van. SMS Elke keer wordt gecontroleerd 20 seconden. u kunt onmiddellijk annuleren.

Meerdere nummers controleren
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 · Geblokkeerd
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 — Beschikbaar; held_balance — Geblokkeerd. USD · 8

Je kunt alleen geld opnemen waarvan de wachttijd is verstreken.

Kant-en-klare clients

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

De persoonlijke API-sleutel van de gebruiker.

Kies een service en land. Betaling per SMS hangt af van het land.

CodeBeschrijving
getNumber / getNumberV2Neem een nummer
getStatus / getStatusV2Krijg de nieuwste code
setStatus / finishActivation / cancelActivationManagement Sessie
getPrices / getNumbersStatusControleer beschikbaarheid
getRewards (SMScash)Beloning voor SMS
getServicesList / getServicesDiensten
getCountries / getOperatorsDiensten en landen
getActiveActivationsZitting
getBalanceGebruikerssaldo
getHoldBalance (SMScash)Geblokkeerd

cost = 0 USD · activationCost = 0 USD
reward — Beloning voor 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'
Antwoord
{
  "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.

Het nummer is geldig voor 20 minuten van. SMS Elke keer wordt gecontroleerd 20 seconden. u kunt onmiddellijk annuleren.

Authentificatie en retries

REST: Hoofdstuk Authorization: Bearer YOUR_API_KEY. Compatibele interface : Parameters api_key en actionGebruik HTTPS

Om API-toets te beheren, voer uw account in.

∞Vragen/min per rekening
∞Samenvattend sessies

API-verzoeken frequentie en het aantal telefoonnummers zijn onbeperkte. er zijn geen dagelijkse of uurtijdse quotaties.

Het nummer is geldig voor 20 minuten van. SMS Elke keer wordt gecontroleerd 20 seconden. u kunt onmiddellijk annuleren.

In de rest, een unieke Idempotency-Key is vereist voor nummerverdeling, herhaalde verdeling, retry en betaling verzoeken. het is optioneel maar aanbevolen in handler_api.php. hergebruik de sleutel bij het retryen van een netwerkverzoek; gebruik een nieuwe sleutel voor een nieuwe operatie.

API sleutelgebied

U kunt een sleutel beperken tot specifieke diensten, landen en leveranciers. lege lijsten toestaan alle beschikbare opties.

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

PATCH /api/v1/keys/{id} De naam en de politiek veranderen volledig. het geheim wordt alleen getoond wanneer het gemaakt is.

10% in totaal. 5% + 5% met software code.

Bij het uitgeven van een nummer, geef dan ref eigenaar van de software. de aanvraag is toegelaten door de sleutel van de gebruiker. de code staat in de "Referrals" sectie en in de GET /api/v1/referrals → software_ref.

VerzoekInviteerSoftware
Geen ref10%—
Met ref5%5%
Met ref, geen referrer—5%

De platform betaalt de bonus zonder de winst van de gebruiker te verminderen.De software-eigenaar en de referrer kunnen dezelfde persoon zijn.

Termen worden vastgesteld wanneer een sessie wordt gecreëerd; lezen SMS en retry Wees ze niet veranderd. pass ref opnieuw voor een nieuwe herhaalde sessie. in de tariefberekening, een gebruiker beloning van USD 0.003 Geeft USD 0.00015 elk aan de software-eigenaar en referrer. de totale bonus is USD 0.00030.

API Command

11 XVBC-stijl methoden plus uw SMScash-balans.

GETgetNumberNeem een nummer

Het salaris en de referral ontvangers worden vastgesteld bij de toewijzing; de salaris wordt gecrediteerd wanneer een SMS met een code aankomt.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
service*stringDe antwoord is beperkt tot het gebied van de API-toets.
country*integerNeem ID van getCountries.
operatorstringNeem ID van operators/getOperators (API). operator=1 · any/0
session_durationintegerDe sessie duurt 20 minuten. pass 20 of om deze parameter te missen.
with_operatorinteger1 voegt het operator-ID aan het antwoord toe; 0 of weglaten geeft drie segmenten terug.
refstringPublic code van de software eigenaar: 5% Voor hem en 5% Voor de gast, zonder ref - 10% aan de gast.

* Verplichte parameter. in alle verzoeken ook pass action=getNumber.

Voorbeeldverzoek

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'

Antwoord

Aantal uitgegeven
ACCESS_NUMBER:42:380670000000:1
Geen cijfers beschikbaar
EMPTY_POOL
  • Automatische keuze: de meeste codes in het afgelopen uur, daarna 24 uur. Geen nummers: volgende operator.
  • Pass Idempotency-Key: hetzelfde verzoek met dezelfde sleutel terugkeert de vorige sessie. Verandering van de parameters IDEMPOTENCY_CONFLICT.
  • Een numerisch land zonder een pool geeft EMPTY_POOL; het verkeerde land formaat is BAD_COUNTRY.
  • De sleutel van een verwijderde sessie blijft gebruikt: het herspel van de toewijzing met die sleutel returns SESSION_CLOSED en geeft geen ander nummer uit.
  • Het toewijzingresultaat is onbevestigd. Automatische terugtrek is uitgeschakeld om een tweede getal te vermijden.
GETgetNumbersStatusControleer beschikbaarheid

Telefoonnummer beschikbaar per dienst en land.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
country*integerNeem ID van getCountries.

* Verplichte parameter. in alle verzoeken ook pass action=getNumbersStatus.

Voorbeeldverzoek

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

Antwoord

beschikbare cijfers
{
  "go_0": 0
}
  • De _0 suffix betekent een keuze zonder een specifieke operator.
  • Beschikbaarheid verwijst naar de totale pool van de leverancier.De geselecteerde kanaal wordt gecontroleerd wanneer een nummer wordt toegewezen.
GETgetStatusKrijg de nieuwste code

Eenvoudige aanvraag voor de sessiestatus en de laatste SMS-code. Leading zeros in de code worden bewaard.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
id*integerID van uw sessie, ontvangen wanneer het nummer is uitgegeven.

* Verplichte parameter. in alle verzoeken ook pass action=getStatus.

Voorbeeldverzoek

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

Antwoord

Wacht
STATUS_WAIT_CODE
Code ontvangen
STATUS_OK:001234
Annulering of uitstel
STATUS_CANCEL
Niet gevonden
NO_ACTIVATION
  • Poll elke 20 Een bericht opnieuw lezen creëert geen andere betaling.
  • Na terugtrek wordt de oude code niet teruggekeerd: getStatus wacht op de volgende SMS.
  • Na een aantal zonder SMS wordt verwijderd, getStatus en getSms terugkeer STATUS_CANCEL; getSmsFull teruggeeft de gesloten status, een leeg telefoon en een leeg sms lijstjes . REST /activations/{id} en /sms terugkeer 404 NO_ACTIVATION.
GETsetStatusManagement Sessie

Uiteindelijk, annuleert of herstelt u wachten op SMS. De sessie is uitgestorven.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
id*integerID van uw sessie, ontvangen wanneer het nummer is uitgegeven.
status*integer3 — wacht op de volgende code zonder de sessie te verlengen; 6 — eindigt na SMS; 8 — onmiddellijk annuleert.

* Verplichte parameter. in alle verzoeken ook pass action=setStatus.

Voorbeeldverzoek

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'

Antwoord

Wacht op SMS
ACCESS_RETRY_GET
voltooid
ACCESS_ACTIVATION
geannuleerd
ACCESS_CANCEL
  • Retry wacht op de volgende code binnen de oorspronkelijke 20 minuten. de uitgang en uitgangstiden veranderen niet.
  • Voor de status =3 Gebruik Idempotency-Key: herhalen van de aanvraag zal de nieuwe code niet herstelt die al is ontvangen. SMS blijft beschikbaar.
  • De annulering verwijdert niet de reeds verdiende beloningen.
  • Alleen nummers met een SMS-code worden in de geschiedenis bewaard. geannuleerde en uitgestelde nummers zonder een code worden verwijderd.
GETgetRepeatNumberZet hetzelfde nummer weer

Open een nieuwe sessie met een specifiek nummer uit je geschiedenis. u kunt een andere beschikbaar service in hetzelfde land selecteren.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
number*stringAlleen nummers en een optionele leiding + zijn toegestaan.
service*stringDe antwoord is beperkt tot het gebied van de API-toets.
session_durationintegerDe sessie duurt 20 minuten. pass 20 of om deze parameter te missen.
with_operatorinteger1 voegt het operator-ID aan het antwoord toe; 0 of weglaten geeft drie segmenten terug.
refstringPublic code van de software eigenaar: 5% Voor hem en 5% Voor de gast, zonder ref - 10% aan de gast.
operatorstringNeem ID van operators/getOperators (API). operator=1 · any/0

* Verplichte parameter. in alle verzoeken ook pass action=getRepeatNumber.

Voorbeeldverzoek

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'

Antwoord

Nieuwe sessie
ACCESS_NUMBER:43:380670000000
Het aantal is nog steeds druk
NUMBER_IN_USE
  • Eerst, beëindigen of annuleren van uw huidige sessie.Als het nummer druk is, wordt de heruitgang niet uitgevoerd.
  • De nieuwe sessie ontvangt een nieuwe ID en de huidige tarief. oude SMS wordt niet gecopierd. ref wordt opnieuw ingesteld.
  • SMScash maakt het mogelijk om alleen nummers uit de geschiedenis van dit account te herhalen.
  • De sleutel van een verwijderde sessie blijft gebruikt: het herspel van de toewijzing met die sleutel returns SESSION_CLOSED en geeft geen ander nummer uit.
GETgetSmsFullSMS als JSON

Structuurd geschiedenis van alle berichten met ID, verzender, code, tekst en land, service en leverancier gegevens.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
id*integerID van uw sessie, ontvangen wanneer het nummer is uitgegeven.

* Verplichte parameter. in alle verzoeken ook pass action=getSmsFull.

Voorbeeldverzoek

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

Antwoord

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"
}
  • Vergeet sms[].id om alleen nieuwe berichten te verwerken.
  • Numerische status SMScash: 1 - actief, 6 - voltooid, 8 - geannuleerd of uitgesteld. status_name onderscheidt tussen wachten, ontvangen, voltooid, geannuleerd, uitgesteld.
  • Ontvangen codes blijven beschikbaar na een sessie sloten. Voor grote volume gebruik REST /activations/{id}/sms met after_id.
  • Na een aantal zonder SMS wordt verwijderd, getStatus en getSms terugkeer STATUS_CANCEL; getSmsFull teruggeeft de gesloten status, een leeg telefoon en een leeg sms lijstjes . REST /activations/{id} en /sms terugkeer 404 NO_ACTIVATION.
GETgetSmsSMS als tekstlijn ontvangen

Terug de hele SMS-historie in stringformaten voor bestaande klanten.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
id*integerID van uw sessie, ontvangen wanneer het nummer is uitgegeven.

* Verplichte parameter. in alle verzoeken ook pass action=getSms.

Voorbeeldverzoek

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

Antwoord

boodschap
STATUS_OK:2026-10-09T12:00:00Z|001234|Код подтверждения: 001234
Wacht
STATUS_WAIT_CODE
Annulering of uitstel
STATUS_CANCEL
  • Het berichtformaat: tijdcode, tekst.Veel berichten worden gescheiden door een kolom.
  • De tekst SMS kan zelf kolommen en verticale bars bevatten. voor betrouwbare parsing, gebruik getSmsFull.
GETgetServicesDiensten

De antwoord is beperkt tot het gebied van de API-toets.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
countryintegerNeem ID van getCountries.

* Verplichte parameter. in alle verzoeken ook pass action=getServices.

Voorbeeldverzoek

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

Antwoord

Diensten
{
  "go": {
    "name": "Google",
    "code": "go"
  }
}
  • De service directory wordt gedeeld door de leverancier. nummer beschikbaarheid wordt afzonderlijk gecontroleerd.
GETgetCountriesLanden

ID's, namen en oproepcodes voor landen in het geselecteerde kanaal.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.

* Verplichte parameter. in alle verzoeken ook pass action=getCountries.

Voorbeeldverzoek

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

Antwoord

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

Beschikbare operators: API-ID, naam en inhoudingsperiode.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
countryintegerNeem ID van getCountries.
operatorstringNeem ID van operators/getOperators (API). operator=1 · any/0

* Verplichte parameter. in alle verzoeken ook pass action=getOperators.

Voorbeeldverzoek

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

Antwoord

Operator
{
  "1": {
    "id": 1,
    "provider_id": 1,
    "operator": 1,
    "name": "Оператор 1",
    "earnings_hold_days": 45
  }
}
  • Neem ID van operators/getOperators (API).
GETgetRewardsBeloning voor SMS

Raten zijn afhankelijk van het land.Alle tabellen zijn per betaald SMS.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
countryintegerNeem ID van getCountries.
servicestringDe antwoord is beperkt tot het gebied van de API-toets.
operatorstringNeem ID van operators/getOperators (API). operator=1 · any/0

* Verplichte parameter. in alle verzoeken ook pass action=getRewards.

Voorbeeldverzoek

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

Antwoord

JSON
{
  "59": {
    "vi": {
      "1": "0.01000000",
      "3": "0.00500000"
    }
  }
}
{}
{}
  • De USD tariefbelangen worden teruggekeerd als exacte decimallijnen met 8 decimal plaatsen:
  • De aanbieders die beschikbaar zijn voor uw sleutel.
  • country ID → service code → operator ID → reward (USD)
GETgetBalanceGebruikerssaldo

Additional SMScash: beschikbare balans rekening houdend met accruals, referral bonussen en betalingsverzoeken.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.

* Verplichte parameter. in alle verzoeken ook pass action=getBalance.

Voorbeeldverzoek

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

Antwoord

Saldo
ACCESS_BALANCE:0.00
  • getBalance geeft de beschikbaar USD-balans met maximaal 8 decimal plaatsen terug.
  • Je kunt alleen geld opnemen waarvan de wachttijd is verstreken.
GETgetHoldBalanceGeblokkeerd

Na ontvangst van een SMS worden de inkomsten vastgehouden gedurende de termijn van de leverancier. Op de aangegeven datum wordt het bedrag automatisch beschikbaar voor opname.

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.

* Verplichte parameter. in alle verzoeken ook pass action=getHoldBalance.

Voorbeeldverzoek

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

Antwoord

Geblokkeerd
ACCESS_HOLD_BALANCE:34.50000001
  • SMScash · getHoldBalance · USD · 8
  • Je kunt alleen geld opnemen waarvan de wachttijd is verstreken.

Antwoordcode en herhaalde verzoeken

In handler_api.php zakelijke resultaten komen meestal met HTTP 200. Check de tekst van het lichaam. Directies en getSmsFull retour JSON als het succesvol is; fouten zijn altijd tekst.

CodeHTTPOorzaak en volgende stap
TARIFF_NOT_CONFIGURED200Raten zijn nog niet vastgesteldHet nummerverdeling begint zodra SMS-beloningen zijn ingesteld.
COUNTRY_BLOCKED200Het nummerverdeling voor dit land is geblokkeerd.Kies een ander land.
BAD_SERVICE200Het nummer voor deze dienst is geblokkeerd.Kies een andere service.
PROVIDER_NOT_READY200Het aantal toewijzing is tijdelijk niet beschikbaarVerfrissing van de API catalogus.
BAD_KEY400Nee api_key of ongeldige formaat.Bekijk de sleutel in de aanvraag.
INVALID_API_KEY401De sleutel is onbekend, geannuleerd of het account is uitgeschakeld.Een geldig API-toets maken.
BAD_COUNTRY400Het land is een positieve cijfer of niet.Neem ID van getCountries.
BAD_SESSION_DURATION400De telefoonnummers worden gedurende 20 minuten uitgegeven.Korrektie session_duration.
BAD_REQUEST400Ongeldige parameter of Idempotency-Key.Laat uw verzoek corrigeren.
BAD_SERVICE / BAD_OPERATOR / INVALID_PROVIDER200Onbekende of ontbrekende directory item.Verfrissing van de API catalogus.
BAD_NUMBER200Onjuiste getal formaat.Geef het nummer in cijfers.
BAD_ACTION / BAD_STATUS200Onbekende bestelling, ID of operatie.Bekijk de instellingen.
EMPTY_POOL200Op dit moment zijn geen matchende telefoonnummers beschikbaar.Herhaal na 10-30 seconden of filter wijzigen.
NUMBER_IN_USE200Een specifiek aantal wordt bezet door een actieve sessie.Uiteindelijk sluit u uw sessie of selecteer een andere nummer.
NO_ACTIVATION200De sessie of het vorige nummer behoort niet tot uw account.Check ID en sleutel.
SESSION_CLOSED / SMS_REQUIRED200De overgang van de staat is momenteel niet beschikbaar.Controleer de omstandigheden en beschikbaarheid van SMS.
SCOPE_BLOCKED200De dienst, land of leverancier is niet toegestaan voor de sleutel.Update de API-toets van de oppervlakte.
IDEMPOTENCY_CONFLICT200Deze zoekopdracht is al geassocieerd met andere parameters.Voor een nieuwe operatie, creëer een andere Idempotency-Key.
BAD_REF / SELF_REF400De softwarecode is onbekend, ontbreekt of behoort tot de gebruiker zelf.Ga naar de code van de software-eigenaar.
INTERNAL_ERROR500Voorlopige server of leverancierfout.Herhaal met een vertraging en dezelfde Idempotency-Key.
ALLOCATION_PENDING200Het nummer toewijzing is al in beweging. Retry met dezelfde Idempotency-Key.Het nummer toewijzing is al in beweging. Retry met dezelfde Idempotency-Key.
ALLOCATION_UNCERTAIN200Het toewijzingresultaat is onbevestigd. Automatische terugtrek is uitgeschakeld om een tweede getal te vermijden.Het toewijzingresultaat is onbevestigd. Automatische terugtrek is uitgeschakeld om een tweede getal te vermijden.

REST geeft een object terug {"error":{"code":"…","message":"…"}} en de reguliere HTTP-status 400/401/403/404/409/503.

JSON
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Controleer de aanvraagvelden.",
    "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.

De rest van nieuwe integraties

De USD tariefbelangen worden teruggekeerd als exacte decimallijnen met 8 decimal plaatsen: 0.00300000 USD.

De balanswissel is USD. aanvraag- en reactieschema's zijn beschikbaar in OpenAPI.

Aftrek in USDT · TRC20Uitbetalingen duren tussen 1 en 45 dagen. De opnamekosten zijn 4 $. Deze worden afgetrokken van het aangevraagde bedrag. Na ontvangst van een SMS worden de inkomsten vastgehouden gedurende de termijn van de leverancier. Op de aangegeven datum wordt het bedrag automatisch beschikbaar voor opname. Je kunt alleen geld opnemen waarvan de wachttijd is verstreken.
GET/api/v1/catalogDiensten en landen
GET/api/v1/tariffsSMS beloningsraten per land
GET/api/v1/offersRaten en beloningen
GET/api/v1/servicesDirectie
GET/api/v1/countriesDirectie
GET/api/v1/operatorsDirectie
GET/api/v1/availability?country=1beschikbaarheid nummer
POST/api/v1/activationsNieuwe sessie
GET/api/v1/activations/batch?ids=42,43Meerdere nummers controleren
GET/api/v1/activationsDe laatste 200 sessies: scope = geschiedenis, wachten of alles
GET/api/v1/activations/{id}Sessie en berichten
GET/api/v1/activations/{id}/sms?after_id=0&limit=100Nieuw SMS Met cursor
POST/api/v1/activations/{id}/retryWacht op SMS
POST/api/v1/activations/{id}/finishvoltooien
POST/api/v1/activations/{id}/cancelannuleren
POST/api/v1/activations/repeatNummer reissue
GET/api/v1/keysAPI Keys
POST/api/v1/keysEen sleutel maken
PATCH/api/v1/keys/{id}Naam of beleid wijzigen
DELETE/api/v1/keys/{id}Kluid terug
GET/api/v1/referralsReferral code en winst
GET/api/v1/summaryBalance en samenvatting
GET/api/v1/balanceGeblokkeerd
GET/api/v1/ledgerWinstverlener Leder
GET/api/v1/withdrawalsVerzoeken om betaling
POST/api/v1/withdrawalsEen verzoek maken
GET/api/v1/statisticsAlgemene statistieken
GET/api/v1/earnings/holdsWachttijd voor inkomsten

Alleen nieuwe ontvangen 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
}

Bewaar next_cursor en overgeven het als after_id. Als has_more=true, de volgende pagina kan onmiddellijk worden gelezen. limiet: 1–200. Sessies en SMS beschikbaar zijn alleen voor de eigenaar.