In-Vault Messages
Retrieve or post encrypted transaction audit messages directly between trade parties.
Request Headers
| Header | Type | Status | Description |
|---|---|---|---|
Authorization | string | Required | Bearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token) |
Content-Type | string | Required | application/json |
GET/v1/p2p/orders/:id/messagesLive & Sandbox
Body Parameters (JSON)
| Parameter | Type | Status | Description |
|---|---|---|---|
vaultReference | string | Required | Vault reference for the message thread |
senderRole | string | Required | buyer or seller |
message | string | Required | Encrypted message body |
Request Code Snippets (cURL, Node, Python, PHP, Go)
Request Example
curl -X GET https://developer.vixzz.com/v1/p2p/orders/ESC_VXZ_749201/messages \
-H "Authorization: Bearer vxz_tok_c2b_8f9k3m9s2a1l"JSON Return Response Body (200 OK)
Response
{
"orderId": "ESC_VXZ_749201",
"messages": [
{
"messageId": "msg_01",
"senderRole": "buyer",
"timestamp": "2026-09-07T02:30:01Z",
"content": "Payment dispatched to counter."
},
{
"messageId": "msg_02",
"senderRole": "seller",
"timestamp": "2026-09-07T02:30:15Z",
"content": "Funds received on ledger. Confirming order release."
}
]
}