# AgentLine Phone Number Provisioning API

> AgentLine Phone Number Provisioning API is a paid API for AI agents from api.agentline.cloud, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Retrieve and lease a real phone number for an AI agent, enabling outbound calls, inbound voice, and SMS capabilities.

## Facts

- Endpoint: GET https://api.agentline.cloud/v1/x402/numbers
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentline-phone-number-provisioning-api-0159a8ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I7WxG0rPBjkfP5ls38Xlg

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 agentline-phone-number-provisioning-api-0159a8ef
```

Example prompt: Get me a real phone number I can use for my AI agent — I need it to handle inbound voice calls and send SMS, and I already have my lease token ready.

## When to prefer this

Choose this endpoint when you need to programmatically provision a real phone number for an AI agent without telecom expertise, especially when building with OpenClaw, Hermes Agent, or custom LLM pipelines that require voice or SMS capabilities. Prefer this over traditional telecom APIs when you want a single unified API for inbound voice, outbound calls, and SMS with x402 micropayment billing.

## Known failure modes

- Invalid or expired lease_token returns an authorization error
- No numbers available in requested region returns an availability error
- Payment not settled before request returns a 402 Payment Required
- Malformed request with missing lease_token returns a 400 Bad Request

## How this service works

Get a real phone number for your AI agent in under 10 minutes. Works with OpenClaw, Hermes Agent, and any LLM. Outbound calls, SMS, and inbound voice — one API. No telecom experience needed.

## Output

Returns a provisioned real phone number and associated lease details including the number's capabilities (inbound voice, outbound calls, SMS), ready for integration with AI agent frameworks like OpenClaw or Hermes Agent.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lease_token": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "numbers": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "owner_wallet": {
   "type": "string"
  }
 }
}
```

## More

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