{"uid":"cap_P9aeW52qovyC_wnoa9Yb4","slug":"blockrun-ai-ccf5c803","name":"BlockRun.AI Phone Number Purchase","description":"Purchase a dedicated phone number valid for 30 days. The number is bound to your wallet address. Default country is US (no regulatory friction). Other countries can be requested via the `country` parameter, but Twilio may require a Regulatory Bundle (KYC) on our account before purchase succeeds — if your country fails, contact care@blockrun.ai to enable.","url":"https://blockrun.ai/api/v1/phone/numbers/buy","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"country":{"type":"string","description":"ISO 2-letter country code. Default: 'US' (always works). 'CA' usually works without friction. Other countries (MX, BR, AR, CL, CO, etc.) require Twilio Regulatory Bundle on our account — if the call returns a 502 with 'regulatory bundle required', contact care@blockrun.ai."},"areaCode":{"type":"string","description":"Preferred area code (US/CA: 3 digits). Availability not guaranteed; if no match, Twilio returns any number in-country."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"5.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$5.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"5.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"5.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CgBc6eNzo_rFbRkNs6vpL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"5.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchase a dedicated phone number (valid 30 days) bound to your wallet address, defaulting to US with optional country and area code selection","exampleAgentPrompt":"Buy me a dedicated US phone number with area code 415 — it should be bound to my wallet and valid for 30 days.","exampleUseCases":null,"resultDescription":"A provisioned phone number assigned to the calling wallet address, valid for 30 days, along with metadata such as the assigned number, country, area code (if matched), and expiration details.","failureModes":["Country requires Twilio Regulatory Bundle (KYC) — returns 502 with 'regulatory bundle required'; contact care@blockrun.ai to enable","Requested area code unavailable — Twilio falls back to any available number in the country","Payment of $5 USDC not authorized or wallet balance insufficient — transaction fails","Invalid ISO country code provided — validation error","Service temporarily unavailable — upstream Twilio outage"],"whenToPreferThis":"Use this endpoint when an AI agent or autonomous wallet needs a dedicated, temporary phone number tied to a specific wallet address for identity, verification, or communication purposes, paid via USDC on-chain. Best for US numbers (no KYC friction); works for CA without friction; use for other countries only after confirming regulatory bundle support with BlockRun.AI.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:51:56.588Z","isFirstParty":false}