# Palmyr Communications – Temporary Phone Number (SMS Receive)

> Palmyr Communications – Temporary Phone Number (SMS Receive) is a paid API for AI agents from palmyr.ai, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-15).

Leases a disposable, receive-only US phone number for 30 minutes to catch a single SMS verification code, billed at $0.20 USDC via x402.

## Facts

- Endpoint: POST https://palmyr.ai/phone/temp
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/palmyr-communications-temporary-phone-number-sms-receive-6b483173
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rADzibDvyifxr9M9lIVom

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 palmyr-communications-temporary-phone-number-sms-receive-6b483173 -d '<json body>'
```

Example prompt: Get me a disposable US phone number I can use to receive a one-time SMS verification code for a new Google account signup — I only need it for about 20 minutes.

## When to prefer this

Choose this endpoint when an AI agent needs to complete SMS-based account verification on a service that accepts VoIP numbers (e.g. Google, X/Twitter, Discord), and a real or permanent phone number should not be exposed. Prefer over permanent number provisioning when the use is strictly one-time and cost-minimization matters. Do not use for Telegram, WhatsApp, or OpenAI verification as those services block VoIP numbers.

## Known failure modes

- No numbers available in pool — pool exhaustion error
- Payment failure or insufficient USDC balance — 402 response
- TTL out of range (below 300 or above 1800 seconds) — validation error
- Target service blocks VoIP numbers (Telegram, WhatsApp, OpenAI) — code never arrives, lease expires unused
- Verification code not received before TTL expires — wait-otp times out

## How this service works

Lease a cheap, instant, receive-only US phone number from a pool to receive one SMS verification code — the phone analogue of a disposable temp email inbox. $0.20 for 30 min (ttl_seconds, clamp 300–1800). Receive-only; call wait-otp to catch the code. Good for one-time verification on sites like Google/X/Discord; some (Telegram/WhatsApp/OpenAI) block VoIP numbers. Recycled — one-time codes only.

## Output

Returns a leased US phone number and a lease ID/token; the agent must then call wait-otp to poll for and retrieve the SMS verification code sent to that number within the TTL window.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "body": {
     "type": "object",
     "additionalProperties": true
    }
   }
  },
  "output": {
   "properties": {
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/palmyr-communications-temporary-phone-number-sms-receive-6b483173/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from palmyr.ai](https://www.zero.xyz/host/palmyr.ai/llms.txt)