Grand SMS
API documentatie

API documentatie

Begin met één verzoek

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

Creëer een API-toets in je dashboard, krijg een nummer en controleer elke 10 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.
Voorbeeldverzoek · cURL
curl --get 'https://smscash.org/stubs/handler_api.php' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'action=getNumber' \
  --data-urlencode 'service=go' \
  --data-urlencode 'country=86'

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

API

Verzoekgenerator

cURL · Go · JS · Python
Compatibiliteit API basis URLhttps://smscash.org/stubs/handler_api.php
cURL
curl --max-time 15 --fail-with-body 'https://smscash.org/stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86&with_operator=1'

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
handler_api.php
GET /stubs/handler_api.php?action=getNumber&api_key=YOUR_API_KEY&service=go&country=86

Automatische selectie: een willekeurige beschikbare aanbieder.

REST
ACCESS_NUMBER: session ID · phone number
service + country · session_duration: 20
ref: software owner code (optional)
operator: public ID (e.g. 1) or comma-separated IDs (e.g. "1,3")
optional · omitted/any/0: random eligible provider
country: integer · service: string · SMS code: string

Het nummer is geldig voor 20 minuten van. SMS Elke keer wordt gecontroleerd 10 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": 10
}
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';

const api = new SmScash(process.env.SMSCASH_API_KEY);
const catalog = await api.catalog({service: 'go', country: 86});
console.log(catalog.rows);

const messages = await api.sms(42, {afterId: 0});
console.log(messages.sms);
const statuses = await api.batch([42]);
const held = await api.holdBalance();
console.log(held); // Exact USD string
Python 3.9+
import os
from smscash import SmScash, SmScashError

api = SmScash(os.environ['SMSCASH_API_KEY'])
catalog = api.catalog(service='go', country=86)
print(catalog['rows'])

messages = api.sms(42, after_id=0)
print(messages['sms'])
statuses = api.batch([42])
held = api.hold_balance()
print(held) # Exact USD string
SDK
me() · balance() · holdBalance()/hold_balance() · catalog() · activation() · sms() · batch()
setStatus(id, "cancel") / set_status(id, "cancel")
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'
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, e.g. 1,3); 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.
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 10 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 10 seconden. u kunt onmiddellijk annuleren.

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.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · 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.
refstringПубличный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.

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

Antwoord

Aantal uitgegeven
ACCESS_NUMBER:42:380670000000:1
Geen cijfers beschikbaar
EMPTY_POOL
  • Automatische selectie: een willekeurige beschikbare aanbieder.
  • 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'

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.
  • 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.
refstringПубличный код владельца софта: 5% ему и 5% пригласившему. Без ref — 10% пригласившему. Неизвестный, отключённый, некорректный или собственный ref игнорируется: запрос продолжается без бонуса владельцу софта. Действующие коды и прежние условия уже выданных сессий сохраняются.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · 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'

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": "operator=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.

Directie

Publiceren…

JSON ↗

De service directory wordt gedeeld door de leverancier. nummer beschikbaarheid wordt afzonderlijk gecontroleerd.

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

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.

Directie

Publiceren…

JSON ↗

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

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.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · 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": "operator=1",
    "earnings_hold_days": 45
  }
}
  • Возьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3.
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.
operatorstringВозьмите ID из operators/getOperators (API). ID поставщиков, через запятую: operator=1,3. operator=1 · operator=1,3 · 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)
GETgetTopCountriesByServiceТоп стран по сервису

До 10 стран с лучшей доставкой смс кодов за последние 24 часа

Parameters

ParametersTypeBeschrijving
api_key*stringDe persoonlijke API-sleutel van de gebruiker.
service*stringКод сервиса из getServices.

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

Voorbeeldverzoek

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

Antwoord

Структура ответа

Ключ в примереBeschrijvingDirectie
["12"], ["36"]Land ID
Первый, внешний уровень JSON. Каждая запись объединяет операторов одной страны.
getCountries
["12"]["1"], ["12"]["3"]ID оператора
Второй уровень JSON, внутри страны. Это публичный ID оператора (поставщика), который передаётся в параметре operator.
getOperators
JSON
{
  "12": {
    "1": {
      "reward": 0.012,
      "count": 542
    },
    "3": {
      "reward": 0.014,
      "count": 301
    }
  },
  "36": {
    "1": {
      "reward": 0.011,
      "count": 190
    }
  }
}
{}
{}
  • В примере ["12"]["1"] — данные оператора 1 в стране 12. ID стран берутся из getCountries, ID операторов — из getOperators.
  • reward — действующее личное вознаграждение в USD, JSON-число. count — количество выданных номеров за последние 24 часа, включая сессии без кода.
  • Рейтинг рассчитывается как все полученные непустые коды, делённые на все выдачи номеров за последние 24 часа для выбранного сервиса.
  • Повторные непустые коды увеличивают числитель; конверсия может превышать 100%. Начальные нули сохраняются.
  • Суточная статистика сервиса кэшируется на 10 минут. Тарифы и ограничения ключа проверяются при каждом запросе. Момент среза — в заголовке X-Statistics-As-Of.
  • Нет данных или доступных связок — пустой объект {}. Страны с выдачами и нулём кодов имеют нулевую конверсию. Порядок ключей JSON не задаёт места в рейтинге.
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_REQUEST400Controleer de aanvraagvelden.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.
INTERNAL_ERROR500Voorlopige server of leverancierfout.Contact en ondersteuning · X-Request-ID
ALLOCATION_PENDING200WachtgetActiveActivations · getStatus
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.