SMS verification API

The SNSSIM API handles number purchase, code verification, cancellation, credit, and price inquiries with a single HTTP request. Using the industry-standard handler_api method, you can connect immediately by changing only the address and API key in your existing program.

GET /stubs/handler_api.php
  ?api_key=API_KEY&action=getNumber
  &service=telegram&country=gb

ACCESS_NUMBER:SS8Q2K7:447700900123

GET ...&action=getStatus&id=SS8Q2K7
STATUS_OK:48215
Industry standard method
handler_api

Industry standard method

Per API key
300 per minute

Per API key

Country / Service
145 / 1,255

Country / Service

Auto refund if no code by then
20 min

Auto refund if no code by then

How do I get an API key?

Generate API keys in your account's API menu after login. Keys appear only once - save immediately. API uses same credit and pricing as web interface.

What is the base address?

All requests are sent via GET method by adding api_key and action parameters to the same address.

https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=...

What requests can I send?

7 types of requests available: number purchase, code check, cancellation, credit balance, and more.

actionWhat it doesSample response
getBalanceCheck creditACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbPrices and available numbers by service and country{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbBuy a numberACCESS_NUMBER:ID:PHONE
getStatus&id=IDCheck codeSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Cancel number (full refund if no code received)ACCESS_CANCEL
setStatus&id=ID&status=3Get additional verification code on same numberACCESS_RETRY_GET
setStatus&id=ID&status=6FinishACCESS_ACTIVATION

Parameter

NameRequiredDescription
api_keyAllAPI key created on the Account screen
actionAllgetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberService code (e.g., telegram, whatsapp, google). Matches values on the services list page.
countrygetNumber2-letter country code (e.g. gb, us, id)
idgetStatus, setStatusNumber ID issued by getNumber (starts with N)
statussetStatus8 to cancel, 3 to request code again, 6 to end, 1 to prepare

Response text and meaning

Responses are provided in concise text. Credit deduction status is also displayed.

ResponseMeaningMoney
ACCESS_NUMBER:ID:PHONEYou got a numberNumber price is charged
STATUS_WAIT_CODEWaiting for the codeUnchanged
STATUS_OK:CODECode receivedPayment complete
STATUS_WAIT_RETRY:CODEWaiting for additional verification codes (includes previous code)No extra cost
STATUS_CANCELCancelled or time is upRefunded if no code arrived
ACCESS_CANCELCancelledFull refund
ACCESS_RETRY_GETWaiting to receive code again on same numberNo extra cost
ACCESS_ACTIVATIONYou finished using the numberUnchanged
NO_BALANCEGet it right after you top upNot charged
NO_NUMBERSCurrently unable to provide numbers for this country.Not charged
NO_ACTIVATIONSYou have 20 open numbersNot charged
EARLY_CANCEL_DENIEDFor numbers that received codes, select End (6), not CancelUnchanged
BAD_KEYInvalid API keyNot charged
BAD_SERVICE / BAD_COUNTRYIncorrect service or country codeNot charged
NO_ACTIVATIONNumber ID not foundUnchanged
TOO_MANY_REQUESTSExceeded 300 requests per minuteNot charged

How does API code retrieval work?

4 steps: receive number, enter it, verify code, then finish.

  1. Step 1

    Get a number

    Use getNumber to select your desired service and country to issue a number.

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. Step 2

    Enter number

    Enter the purchased number on the sign-up page or program.

    +44 7700 900123
  3. Step 3

    Check code

    Call getStatus every 5 seconds to check if the code has arrived.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. Step 4

    Finish

    After entering the code, complete with setStatus 6. Unused numbers auto-refund within 20 minutes.

    action=setStatus&id=SS8Q2K7&status=6
    > ACCESS_ACTIVATION

Examples by language

The full process: get a number, wait for code, then complete. Tap to change language.

import time, requests

BASE = "https://snssim.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

API FAQs

The API offers numbers from 145 countries and 1,255 services at the same prices as the web interface.

What is an SMS verification API?
Programmatically buy numbers, check codes, and cancel via HTTP requests. SNSSIM API uses industry-standard handler_api.
Can I keep using programs from other SMS verification sites?
If your program uses the handler_api method, just change the base address and API key to connect immediately.
Is there a separate API fee?
No difference. API and web interface use the same credit and pricing.
How many requests are allowed?
Up to 300 requests per minute per API key. Exceeding this limit results in a TOO_MANY_REQUESTS error, and no credit is deducted.
Can numbers bought via API be refunded?
Yes. If the code doesn't arrive within 20 minutes, numbers purchased via API are also automatically refunded as credit.
Where do I create an API key?
Generate in the API menu after login. Keys are shown only once upon generation - save immediately.

Connect immediately after generating an API key

After signing up, top up your credit to generate an API key directly on the account screen.

SMS verification API | SNSSIM