# Palmyr SMS Inbox Reader

> Palmyr SMS Inbox Reader is a paid API for AI agents from palmyr.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-12).

Retrieves all SMS messages received on a Palmyr-managed phone number you own or have shared access to.

## Facts

- Endpoint: GET https://palmyr.ai/phone/numbers/test/messages?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/palmyr-sms-inbox-reader-7efb5302
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JfuWqCrhqS__bIikDkMOD

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-sms-inbox-reader-7efb5302
```

Example prompt: Check all the SMS messages received on my Palmyr phone number and show me what came in.

## When to prefer this

Use this endpoint when you need to programmatically read incoming SMS messages on a Palmyr-managed phone number, especially in agentic workflows where an AI needs to monitor texts, capture verification codes, or process replies. Prefer this over general SMS APIs when already using Palmyr's x402 crypto-payment infrastructure or when operating with a Palmyr-provisioned number.

## Known failure modes

- Phone number not found or not owned/shared — returns 404 or access denied error
- Authentication failure — invalid or missing credentials returns 401
- No messages received — returns empty list
- Rate limiting or quota exceeded — returns 429
- Payment failure via x402 — call rejected if USDC payment is not processed

## How this service works

Read all SMS messages received on a phone number you own or have shared access to.

## Output

A list of SMS messages received on the specified phone number, including message content, sender details, and timestamps. The response contains all messages accessible to the authenticated owner or shared-access user.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/palmyr-sms-inbox-reader-7efb5302/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)