# PhoneAgent Services Directory

> PhoneAgent Services Directory is a paid API for AI agents from api.phoneagent.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the full catalog of 1,000+ services (Telegram, WhatsApp, Google, etc.) for which SMS phone numbers can be rented, including alias codes and cheapest prices

## Facts

- Endpoint: GET https://api.phoneagent.xyz/services
- 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/phoneagent-services-directory-cd8964d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RRKj5KYQ-hAFQXl8cuDWL

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 phoneagent-services-directory-cd8964d1
```

Example prompt: Show me all the services PhoneAgent supports for renting SMS numbers — I want to see the full list with alias codes and cheapest prices so I can figure out which one to use for Telegram verification.

## When to prefer this

Use this endpoint before calling POST /rent to discover the correct service alias code and cheapest available price tier. Essential when you don't know the alias for a given platform or want to enumerate all supported services. Pair with ?country=<iso> to narrow results to a specific country's inventory.

## Known failure modes

- Invalid country ISO code returns empty or error response
- Rate limiting if called excessively
- Service catalog may be stale if not refreshed — use live call for current inventory
- Missing or malformed query param may return full unfiltered list instead of country-specific data

## How this service works

PhoneAgent — full directory of services with rentable SMS phone numbers for AI agents. Returns 1,000+ service aliases: Telegram, WhatsApp, Google, Facebook, Instagram, Twitter/X, Discord, Apple, PayPal, OpenAI/ChatGPT, Claude, plus crypto/Web3 onboarding (Alchemy, Coinbase, Binance, Bybit, OKX, Kraken, Robinhood, ...). Use `other` for any platform not separately listed. Each entry shows the alias to pass to POST /rent and the cheapest price tier ($1, $2, or $5 USDC). Add ?country=<iso> (e.g.

## Output

An array of service objects each containing: a short alias code to pass to POST /rent (e.g. 'tg' for Telegram, 'wa' for WhatsApp, 'zo' for OpenAI), a human-readable display name, and the cheapest SKU price in USDC (1, 2, or 5) across all countries. If ?country=<iso> is provided, results are filtered to that country with live prices and inventory.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "code": {
        "type": "string",
        "description": "Service alias — pass verbatim as `service` in POST /rent (e.g. tg, wa, zo for OpenAI, other for any platform)."
       },
       "name": {
        "type": "string"
       },
       "from_usdc": {
        "type": "number",
        "description": "Cheapest SKU price for this service across countries (1, 2, or 5)."
       }
      }
     },
     "description": "Services with rentable SMS numbers somewhere in the catalog. Each entry: the alias to pass as `service` in POST /rent, a display name, and the cheapest SKU price across all countries. Add ?country=<iso> to get the services offered in one country with live price and inventory pool. Companion route GET /countries lists countries (filter with ?service=<code>)."
    }
   }
  }
 }
}
```

## More

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