# AgentPhone Number Provisioning

> AgentPhone Number Provisioning is a paid API for AI agents from api.agentphone.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Provisions a new phone number for an AI agent, optionally filtered by country and area code

## Facts

- Endpoint: POST https://api.agentphone.ai/x402/v1/numbers
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentphone-number-provisioning-eb24af69
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GXpFLar-L0vDQeh9FedsU

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 agentphone-number-provisioning-eb24af69 -d '<json body>'
```

Example prompt: Get me a US phone number with a 415 area code for my agent with ID 'agent-abc123'.

## When to prefer this

Use this endpoint when an AI agent needs to be assigned a real phone number for outbound or inbound calling capabilities, especially when you need to filter by country or area code. Prefer this over manual provisioning workflows when building automated agent pipelines that require telephony access.

## Known failure modes

- Area code unavailable — no numbers available in the requested area code
- Invalid country code — unsupported or malformed country string
- Agent ID conflict — agent already has a provisioned number
- Payment failure — insufficient USDC balance or x402 payment not accepted
- Rate limit exceeded — too many provisioning requests in a short window

## How this service works

Service: AgentPhone (https://api.paysponge.com/v1/numbers)

## Output

Returns details of the newly provisioned phone number, including the assigned number, country, and area code associated with the given agent ID.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "agentId": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "title": "Agentid"
  },
  "country": {
   "type": "string",
   "title": "Country",
   "default": "US"
  },
  "areaCode": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "title": "Areacode"
  }
 }
}
```

## More

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