# BlockRun.AI Phone Number Purchase

> BlockRun.AI Phone Number Purchase is a paid API for AI agents from blockrun.ai, paid per call via x402, $5.001/call, status unknown (last checked 2026-09-13).

Purchase a dedicated phone number (valid 30 days) bound to your wallet address, defaulting to US with optional country and area code selection

## Facts

- Endpoint: POST https://blockrun.ai/api/v1/phone/numbers/buy
- Price: $5.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockrun-ai-ccf5c803
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P9aeW52qovyC_wnoa9Yb4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockrun-ai-ccf5c803 -d '<json body>'
```

Example prompt: Buy me a dedicated US phone number with area code 415 — it should be bound to my wallet and valid for 30 days.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockrun-ai-ccf5c803/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blockrun.ai](https://www.zero.xyz/host/blockrun.ai/llms.txt)