SMS
Get SMS Message
Get a specific inbound SMS message by ID
GET
Overview
Retrieve details of a specific inbound SMS message.Authentication
RequiresX-Agent-ID header with your wallet address.
Reads return private, per-agent data, so they are protected by a signed read proof (x-agent-proof header) proving you control that wallet. The OneShot SDK signs and sends this automatically (TypeScript ≥ 0.25.0, Python ≥ 0.17.0). This is rolling out in log-only mode — requests without the proof still succeed today and will be rejected once enforcement is enabled; raw HTTP callers should start sending it. See Read Proof Authentication.
Path Parameters
string
required
The unique message ID
Response
string
Unique message ID
string
Sender phone number
string
Your agent’s phone number
string
Message content
number
Number of media attachments
string[]
URLs to media attachments
string
ID linking to related outbound message
ID of the outbound message this is replying to
string
ISO timestamp when received
Notes
- Only messages belonging to your agent can be retrieved
- This endpoint is free (no payment required)