Skip to main content
GET
/
agents
/
{agentId}
/
convos
/
{convoId}
Get Single Conversation
curl --request GET \
  --url https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos/{convoId} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "<string>",
  "data": {}
}
Returns full conversation metadata including lead information. You must own the agent to access its conversations.
Use this endpoint to fetch conversation details before exporting or to check user feedback status.

​
Example Response

{
  "success": true,
  "message": "Conversation retrieved successfully",
  "data": {
    "ID": "agent123_convo456",
    "userID": "agent123_convo456",
    "ts": 1699999999,
    "messagesNum": 5,
    "userName": "John Doe",
    "userEmail": "[email protected]",
    "userPhone": "+1234567890",
    "userCompany": "Acme Corp",
    "userAddress": "123 Main St, City, State",
    "userWebsite": "https://acme.com",
    "notes": "Customer interested in premium plan, follow up next week",
    "tags": ["new-lead", "high-priority"],
    "origin": "web-chat",
    "state": "ai-chatting",
    "firstMessageTS": 1699999000,
    "lastMessageTS": 1699999999,
    "lastModified": 1699999999
  }
}

​
Response Fields

The response includes all conversation metadata:

​
Lead Information

  • userName, userEmail, userPhone - Contact information
  • userAddress, userCompany, userWebsite - Additional details
  • notes - Internal notes about the conversation/lead
  • userProfilePic - Profile picture URL

​
Conversation Data

  • ID, userID - Identifiers
  • messagesNum - Number of messages exchanged
  • tags - Categorization tags
  • state - Current conversation state
  • origin - Channel (e.g., “web-chat”, “whatsapp”)
  • Timestamps: ts, firstMessageTS, lastMessageTS, lastModified

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
agentId
string
required

The unique identifier of the agent

​
convoId
string
required

The unique identifier of the conversation

Response

Conversation retrieved successfully

​
success
boolean
required
​
message
string
required
​
data
object

Conversation object