Phone & Voice

The number is leased to your wallet for 30 days and auto-registered with Bland so it can be used as outbound caller-ID.

# Send unpaid; server returns 402 with payment requirements
curl -X POST https://blockrun.ai/api/v1/phone/numbers/buy \
  -H "Content-Type: application/json" \
  -d '{"country":"US","areaCode":"415"}'

# Sign EIP-3009 USDC transfer from your wallet,
# then replay with the signed X-Payment header.
# Response:
# {
#   "phone_number": "+14155551234",
#   "expires_at":   "2026-06-15T00:00:00.000Z",
#   "chain":        "base",
#   "message":      "Number provisioned for 30 days..."
# }

from is required and must be a number your wallet owns. task is plain English — describe what the AI should say and do.

curl -X POST https://blockrun.ai/api/v1/voice/call \
  -H "Content-Type: application/json" \
  -d '{
    "to":   "+12025551234",
    "from": "+14155551234",
    "task": "Hi, this is Maya from BlockRun. Confirm tomorrow at 3pm and ask the recipient to press 1 to confirm or 2 to reschedule. Keep it under 60 seconds.",
    "voice": "maya",
    "max_duration": 5
  }'

# Response (after settlement):
# {
#   "call_id":  "0721a3f8-9ae6-...",
#   "status":   "success",
#   "poll_url": "https://blockrun.ai/api/v1/voice/call/0721a3f8-...",
#   "message":  "Call initiated. Poll poll_url for status, transcript, and recording."
# }

Status, duration, full transcript, recording URL, and whether a human or voicemail picked up. No payment needed.

curl https://blockrun.ai/api/v1/voice/call/0721a3f8-...

# Response (when completed):
# {
#   "status":       "completed",
#   "call_length":  0.75,        // minutes
#   "answered_by":  "human",     // or "voicemail" / "no-answer"
#   "from":         "+14155551234",
#   "to":           "+12025551234",
#   "concatenated_transcript": "...",
#   "recording_url": "https://..."
# }