Skip to main content
GET
/
v1
/
tools
/
sms
/
inbox
/
{messageId}
curl -X GET "https://win.oneshotagent.com/v1/tools/sms/inbox/msg_abc123" \
  -H "X-Agent-ID: 0xYourWalletAddress"

{
  "id": "msg_abc123",
  "from": "+14155551234",
  "to": "+14151234567",
  "body": "Yes, I'd like to confirm my appointment for Tuesday at 2pm",
  "num_media": 0,
  "media_urls": null,
  "thread_id": "msg_outbound_xyz",
  "related_outbound_id": "msg_outbound_xyz",
  "received_at": "2024-01-15T10:30:00Z",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Overview

Retrieve details of a specific inbound SMS message.

​
Authentication

Requires X-Agent-ID header with your wallet address.

​
Path Parameters

​
messageId
string
required
The unique message ID

​
Response

​
id
string
Unique message ID
​
from
string
Sender phone number
​
to
string
Your agent’s phone number
​
body
string
Message content
​
num_media
number
Number of media attachments
​
media_urls
string[]
URLs to media attachments
​
thread_id
string
ID linking to related outbound message
​
related_outbound_id
string
ID of the outbound message this is replying to
​
received_at
string
ISO timestamp when received
curl -X GET "https://win.oneshotagent.com/v1/tools/sms/inbox/msg_abc123" \
  -H "X-Agent-ID: 0xYourWalletAddress"

{
  "id": "msg_abc123",
  "from": "+14155551234",
  "to": "+14151234567",
  "body": "Yes, I'd like to confirm my appointment for Tuesday at 2pm",
  "num_media": 0,
  "media_urls": null,
  "thread_id": "msg_outbound_xyz",
  "related_outbound_id": "msg_outbound_xyz",
  "received_at": "2024-01-15T10:30:00Z",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Notes

  • Only messages belonging to your agent can be retrieved
  • This endpoint is free (no payment required)