Cascade OTP in Python

Cascade provides a REST API. Below is a practical minimum in Python with the requests client.

Useful links: API, send, verify, examples, FAQ, pricing, documentation.

Installation

pip install requests

An official SDK may not exist — an HTTP client is enough.

Initialization

import os
import requests

BASE = os.getenv("OTP_API_BASE_URL", "https://cascade.kz/api")
TOKEN = os.getenv("OTP_API_TOKEN")
HEADERS = {
    "Authorization": f"Bearer {TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
}

def cascade(path: str, payload: dict) -> dict:
    r = requests.post(f"{BASE}{path}", json=payload, headers=HEADERS, timeout=30)
    return r.json()

Send

send = cascade("/otp/send", {"phone": "77001234567", "purpose": "verification"})
assert send.get("success"), send.get("message")

Verify

verify = cascade("/otp/verify", {"phone": "77001234567", "code": "482910", "purpose": "verification"})
assert verify.get("success"), verify.get("message")

Handle success is False and HTTP 401/422/429. See errors, FAQ, use-cases.