# Palmyr Phone Call DTMF/Speech Gather

> Palmyr Phone Call DTMF/Speech Gather is a paid API for AI agents from palmyr.ai, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-13).

Collects DTMF tones or speech input from an active phone call by sending a gather prompt to the specified call.

## Facts

- Endpoint: POST https://palmyr.ai/phone/calls/%7BcallControlId%7D/gather
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/palmyr-phone-call-dtmf-speech-gather-d257f903
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8oUIb2f5AIUqZMpPuO3CR

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-phone-call-dtmf-speech-gather-d257f903 -d '<json body>'
```

Example prompt: On the active call with control ID 'ctrl_abc123', prompt the caller to press 1 for sales or 2 for support, and gather their keypad input.

## When to prefer this

Use this endpoint when you need to interactively collect input (keypresses or speech) from a caller during an active Palmyr-managed phone call — particularly in IVR flows, menu prompts, or any step where an AI agent needs to branch logic based on caller response. Prefer this over polling-based approaches when you need real-time in-call input collection.

## Known failure modes

- Call control ID not found or invalid — 404 error
- Call has already ended before gather can be initiated — state conflict error
- Caller does not respond within timeout window — timeout/no-input event
- Payment not completed — 402 Payment Required response
- Invalid gather parameters in request body — 400 Bad Request
- Network or telephony provider error during gather — 5xx error

## How this service works

Autonomous infrastructure for AI agents — pay with USDC on Solana or Base via x402.

## Output

Returns the gathered input from the caller — either DTMF digits pressed or transcribed speech — along with the call control ID and event metadata indicating what the caller entered in response to the prompt.

## 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-phone-call-dtmf-speech-gather-d257f903/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)