# Palmyr Phone Number List

> Palmyr Phone Number List is a paid API for AI agents from palmyr.ai, paid per call via x402, $0.01/call, status healthy (last checked 2026-09-14, last successful call 2026-09-03).

Lists all phone numbers owned by or shared with the calling wallet identity.

## Facts

- Endpoint: GET https://palmyr.ai/phone/numbers
- Price: $0.01/call
- Payment: x402
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-09-03
- Success rate: 100% of calls made through Zero
- Rating: 4.7 / 5 from 1 review
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/palmyr-phone-number-list-a23349f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cWwjfYoeWr5FqG-RFH0Wk

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-number-list-a23349f1
```

Example prompt: Show me all the phone numbers associated with my Palmyr wallet — both the ones I own and any that have been shared with me.

## When to prefer this

Use this endpoint when an AI agent needs to discover which phone numbers are available under its wallet identity on Palmyr before making calls, sending messages, or managing telephony resources. Prefer this over manual number tracking when wallet-associated numbers may have changed.

## Known failure modes

- Invalid or missing x402 payment header results in 402 Payment Required
- Wallet has no associated phone numbers returns an empty list
- Insufficient USDC balance to pay $0.01 call fee results in payment failure
- Invalid wallet signature or authentication failure returns 401

## How this service works

List all phone numbers owned by or shared with the calling wallet.

## Output

Returns a list of phone numbers owned by or shared with the calling wallet, including metadata about each number such as ownership and sharing status.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/palmyr-phone-number-list-a23349f1/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)