# SMS Inbox Reader — Physical SIM

> SMS Inbox Reader — Physical SIM is a paid API for AI agents from api.x-402.online, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-09).

Returns all messages received by a rented phone number, including sender, body, and reception timestamp, enabling an agent to extract verification codes autonomously.

## Facts

- Endpoint: GET https://api.x-402.online/v1/sms/inbox?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sms-inbox-reader-physical-sim-19ba6aaf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AF-VFVCRwqY7FglZn2ugp

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 sms-inbox-reader-physical-sim-19ba6aaf
```

Example prompt: Check the SMS inbox on my rented number and pull out any verification code or OTP that just came in — I need it to complete the signup flow.

## When to prefer this

Use this endpoint when your agent needs to autonomously retrieve a verification code or OTP sent via SMS to a rented physical SIM number — especially when the target service rejects virtual or VoIP numbers. This is preferable to any virtual number service when dealing with strict carrier filtering.

## Known failure modes

- No messages in inbox yet — returns empty list if no SMS has arrived
- Number not rented or expired — returns an error if the number is no longer active
- Payment failure — 402 response if USDC payment is not settled
- Rate limiting — too many polls in a short window may be throttled
- SMS delivery delay — message may not have arrived yet at poll time

## How this service works

Read the messages received by a phone number rented through /v1/sms/number: sender, body, and reception time, returned as structured data so an agent can extract a verification code without human help. The number is a physical SIM in a handset we operate, so it receives from senders that refuse virtual lines.

## Output

A structured list of SMS messages received by the rented phone number, each containing the sender's number, the full message body (including any OTP or verification code), and the timestamp of reception. The agent can parse the body to extract codes without human involvement.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "otp": "483920",
  "count": 1,
  "phone": "+590690XXXXXX",
  "messages": [
   {
    "body": "G-483920 is your code",
    "sender": "Google"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sms-inbox-reader-physical-sim-19ba6aaf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x-402.online](https://www.zero.xyz/host/api.x-402.online/llms.txt)