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.