# Palmyr Communications – Wait for OTP/SMS Verification Code

> Palmyr Communications – Wait for OTP/SMS Verification Code is a paid API for AI agents from palmyr.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Blocks up to 90 seconds waiting for an SMS OTP to arrive on a phone number you own, then returns the parsed verification code.

## Facts

- Endpoint: POST https://palmyr.ai/phone/numbers/:id/wait-otp
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/palmyr-communications-wait-for-otp-sms-verification-code-070b48ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__GqybrdJaW4RKIMksS29t

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-wait-for-otp-sms-verification-code-070b48ad -d '<json body>'
```

Example prompt: Wait up to 60 seconds for the OTP to arrive on phone number ID ph_abc123 — use a lookback of 0 seconds since it's a reused number — and return the verification code.

## When to prefer this

Use this endpoint when your agent needs to autonomously complete an SMS-based verification or 2FA flow on a phone number it controls, especially in automated signup, login, or account verification workflows where waiting for the OTP inline (up to 90s) is acceptable.

## Known failure modes

- Timeout: no OTP arrives within the specified timeout window (up to 90s), returning a timeout error
- Pattern mismatch: an SMS arrives but no code matches the expected pattern
- Invalid phone number ID: the specified number does not belong to the authenticated wallet
- Invalid regex pattern: the custom pattern exceeds 256 characters or is malformed
- Payment failure: the $0.02 USDC x402 payment is not completed or rejected

## How this service works

Wait (blocking, up to 90s) for an SMS verification code / OTP to arrive on a phone number you own, and return the parsed code. Body (all optional): { timeout_s (default 60, max 90), lookback_s (default 10; pass 0 for reused numbers), pattern (custom regex, max 256 chars) }

## Output

Returns the parsed OTP/verification code extracted from the SMS that arrived on the specified phone number, along with metadata about the matched message.

## 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-wait-for-otp-sms-verification-code-070b48ad/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)