In-Vault Messages

Retrieve or post encrypted transaction audit messages directly between trade parties.

Request Headers

HeaderTypeStatusDescription
AuthorizationstringRequiredBearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token)
Content-TypestringRequiredapplication/json
GET/v1/p2p/orders/:id/messagesLive & Sandbox

Body Parameters (JSON)

ParameterTypeStatusDescription
vaultReferencestringRequiredVault reference for the message thread
senderRolestringRequiredbuyer or seller
messagestringRequiredEncrypted 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."
    }
  ]
}