Receive SMS verification codes with Python

This guide uses the requests library and an API key stored in an environment variable. The same flow works from any language that can make HTTPS calls.

Set up

• Create an account, add funds and open the API page in the dashboard to generate a key (it starts with nsk_live_).
• Run pip install requests.
• Export the key: export NOIRSMS_KEY=nsk_live_...

Buy a number and wait for the code

The script buys a Telegram (tg) number in the US, prints it, then polls until the SMS arrives or the number closes.

import os, time, requests

API = "https://noirsms.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['NOIRSMS_KEY']}"}

def buy(service, country, max_price=None):
    body = {"service": service, "country": country}
    if max_price:
        body["max_price"] = max_price
    r = requests.post(f"{API}/numbers", json=body, headers=H, timeout=20)
    r.raise_for_status()
    return r.json()

def wait_for_code(number_id, timeout=20 * 60):
    end = time.time() + timeout
    while time.time() < end:
        n = requests.get(f"{API}/numbers/{number_id}", headers=H, timeout=20).json()
        if n["status"] == "received":
            return n["sms"][0]["code"]
        if n["status"] in ("canceled", "expired"):
            return None
        time.sleep(4)
    return None

n = buy("tg", "us")
print("Enter this number in the app:", n["phone"])
print("Code:", wait_for_code(n["id"]))

Good habits

• Read service codes from GET /services?country=us instead of hard-coding prices.
• Pass max_price so a price change can't surprise you (HTTP 409 price_above_max).
• Stay under 120 requests per minute per key; polling every 4 seconds is plenty.
• Call POST /numbers/{id}/finish when you're done, or /cancel after 2 minutes if the app refused the number.

Use it responsibly

Use the API only for your own legitimate accounts or apps you're authorized to test, and make sure your customers follow the same Acceptable Use Policy.