Developer REST API Documentation & Reseller Hub

🔑 1. Authentication

All API requests require your Bearer API token in the Authorization header or passed as an api_key query parameter.

HEADER FORMAT

Authorization: Bearer YOUR_SECRET_API_KEY

Base URL for all REST endpoints: https://usaverifypro.com/api

💰 2. Get User Balance & Profile

Retrieve your real-time account balance and profile details.

GET /api/me

cURL REQUEST

curl -X GET "https://usaverifypro.com/api/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

JSON RESPONSE (200 OK)

{
  "ok": true,
  "email": "user@example.com",
  "balance": 25.50,
  "currency": "USD"
}

🇺🇸 3. Rent Real USA Physical Non-VoIP Number

Rent a clean physical SIM line from AT&T, Verizon, or T-Mobile tailored for specific services.

POST /api/order

Parameter	Type	Description
service	string	Service code (e.g. `wa` for WhatsApp, `tg` for Telegram, `openai` for ChatGPT, `go` for Google).
max_price	float (optional)	Maximum price limit you are willing to pay.

PYTHON EXAMPLE

import requests

res = requests.post(
    "https://usaverifypro.com/api/order",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"service": "wa"} # WhatsApp
)
data = res.json()
print("Order ID:", data["id"])
print("Phone Number:", data["number"]) # e.g. +14159021234

📨 4. Receive SMS OTP Code (Automatic Multi-Code)

Check the status of an active number rental to retrieve incoming SMS codes. Supports automatic multi-code resends.

GET /api/check_sms?id=ORDER_ID

JSON RESPONSE (CODE DELIVERED)

{
  "status": "STATUS_OK",
  "code": "849201",
  "codes": ["849201"],
  "number": "+14159021234"
}

🔄 5. Cancel Order & Auto-Refund

Cancel an active order if you wish to release the line early. If no SMS was received, your balance is refunded 100% automatically.

POST /api/cancel

PAYLOAD

{
  "id": "1948201",
  "status": "8" // 8 = Cancel & Refund
}

🐍 6. Official Python SDK

Install and use our zero-dependency Python wrapper for seamless automated pipelines:

QUICKSTART

from usaverify import USAVerify

client = USAVerify(api_key="YOUR_API_KEY")

# 1. Rent line
order = client.rent_number(service="whatsapp")
print(f"Number: {order['number']}")

# 2. Wait for code
code = client.get_sms_code(order_id=order["id"], timeout=120)
print(f"✅ OTP: {code}")