Skip to main content
GET
/
v1
/
messages
curl --request GET \
  --url 'https://api.neyrs.cloud/v1/messages?sessionId=session_abc123def456&limit=50' \
  --header 'Authorization: Bearer pixie_live_abc123def456'

{
  "messages": [
    {
      "messageId": "msg_abc123def456",
      "role": "user",
      "content": "Swap 5 SOL for USDC",
      "timestamp": "2024-03-08T14:30:00Z",
      "intent": {
        "action": "swap",
        "confidence": 0.98
      }
    },
    {
      "messageId": "msg_xyz789ghi012",
      "role": "agent",
      "content": "I'll swap 5 SOL for USDC. Expected output: ~736.25 USDC",
      "timestamp": "2024-03-08T14:30:01Z"
    }
  ],
  "pagination": {
    "hasMore": false,
    "nextCursor": null
  }
}

​
Authorization

​
Authorization
string
required
Bearer token. Format: Bearer pixie_live_abc123def456

​
Query Parameters

​
sessionId
string
required
Session ID. Format: session_<16 chars>
​
limit
number
Number of messages to return. Default: 50, Max: 100
​
cursor
string
Pagination cursor for next page

​
Response

​
messages
array
Array of message objectsEach message contains:
  • messageId (string): Message identifier
  • role (string): user or agent
  • content (string): Message text
  • timestamp (string): ISO 8601 timestamp
  • intent (object): Parsed intent (if applicable)
​
pagination
object
Pagination metadataProperties:
  • hasMore (boolean): More messages available
  • nextCursor (string): Cursor for next page
curl --request GET \
  --url 'https://api.neyrs.cloud/v1/messages?sessionId=session_abc123def456&limit=50' \
  --header 'Authorization: Bearer pixie_live_abc123def456'

{
  "messages": [
    {
      "messageId": "msg_abc123def456",
      "role": "user",
      "content": "Swap 5 SOL for USDC",
      "timestamp": "2024-03-08T14:30:00Z",
      "intent": {
        "action": "swap",
        "confidence": 0.98
      }
    },
    {
      "messageId": "msg_xyz789ghi012",
      "role": "agent",
      "content": "I'll swap 5 SOL for USDC. Expected output: ~736.25 USDC",
      "timestamp": "2024-03-08T14:30:01Z"
    }
  ],
  "pagination": {
    "hasMore": false,
    "nextCursor": null
  }
}