OTP Verification for AI Agents

cURL

# 1. Provision a number
curl -X POST https://www.agent-utils.com/api/otp \
  -H "x-api-key: au_your_key" \
  -H "Content-Type: application/json" \
  -d '{"countryCode": "US"}'

# 2. Use the number to trigger SMS
# 3. Read the OTP code
curl https://www.agent-utils.com/api/otp/{sessionId} \
  -H "x-api-key: au_your_key"

Python

import requests

# Provision a number
resp = requests.post(
    "https://www.agent-utils.com/api/otp",
    headers={"x-api-key": "au_your_key"},
    json={"countryCode": "US"},
)
session = resp.json()["data"]
phone_number = session["phoneNumber"]

# Later: check for OTP code
resp = requests.get(
    f"https://www.agent-utils.com/api/otp/{session['id']}",
    headers={"x-api-key": "au_your_key"},
)
code = resp.json()["data"]["code"]

JavaScript

// Provision a number
const res = await fetch("https://www.agent-utils.com/api/otp", {
  method: "POST",
  headers: { "x-api-key": "au_your_key", "Content-Type": "application/json" },
  body: JSON.stringify({ countryCode: "US" }),
});
const { data: session } = await res.json();

// Later: check for OTP code
const otp = await fetch(
  `https://www.agent-utils.com/api/otp/${session.id}`,
  { headers: { "x-api-key": "au_your_key" } }
);
const { data } = await otp.json();
console.log(data.code); // "482917"