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": {
    "userEmail": "<string>",
    "userName": "<string>",
    "userPhone": "<string>",
    "userAddress": "<string>",
    "userCompany": "<string>",
    "userWebsite": "<string>",
    "notes": "<string>",
    "userProfilePic": "<string>",
    "ID": "<string>",
    "userID": "<string>",
    "campaignId": "<string>",
    "userImage": "<string>",
    "socialHandle": "<string>",
    "isFollowingBusiness": true,
    "socialVerified": true,
    "userOs": "<string>",
    "userBrowser": "<string>",
    "origin": "<unknown>",
    "whatsappPhoneNumberId": "<string>",
    "whatsappBusinessNumber": "<string>",
    "whatsappDisplayPhoneNumber": "<string>",
    "whatsappBusinessAccountId": "<string>",
    "messagesNum": 123,
    "interactionsNum": 123,
    "ts": 123,
    "tags": [
      "<string>"
    ],
    "convoTimeSeconds": 123,
    "firstMessageTS": 123,
    "lastMessageTS": 123,
    "userPlatform": "<string>",
    "chatAssignedTo": "<string>",
    "handoffHistory": [
      {
        "requestedAt": 123,
        "acceptedAt": 123,
        "completedAt": 123,
        "acceptedBy": "<string>",
        "organizationId": "<string>",
        "requestedTeamKey": "<string>",
        "teamIds": [
          "<string>"
        ],
        "teamKeys": [
          "<string>"
        ]
      }
    ],
    "isTyping": true,
    "lastModified": 123,
    "sessionsNum": 123,
    "lang": "<string>",
    "vapi": {
      "cost": 123,
      "callDuration": 123,
      "recordingUrl": "<string>",
      "callerPhoneNumber": "<string>",
      "calleePhoneNumber": "<string>",
      "callStatus": "<string>",
      "callError": "<string>"
    },
    "ratingFrom5": 123,
    "totalUserInteractions": 123,
    "isBlocked": true,
    "nodesInfo": {
      "currentNode": "<string>"
    },
    "capturedVariables": "<unknown>",
    "campaignCalls": "<array>",
    "sessions": "<array>",
    "endReason": "<string>",
    "isTest": true,
    "metrics": "<array>",
    "notifyToUserId": "<string>",
    "averageLatency": 123,
    "voice": {
      "latestSessionId": "<string>",
      "listenUrl": "<string>",
      "listenUrlUNIX": 123
    },
    "detailedCost": {
      "totalCreditsConsumed": 123,
      "speechGenCost": 123,
      "transcriberCost": 123,
      "twilioCost": 123,
      "llmCost": 123
    },
    "summary": "<string>",
    "requestedTeamKey": "<string>",
    "delegatedBy": "<string>",
    "delegatedAt": 123,
    "lastViewed": 123,
    "note": "<string>",
    "leadScore": 0,
    "funnelStepsMatched": [],
    "funnelScoreHistory": [],
    "funnelNotificationSent": false,
    "funnelLastEvaluated": 123,
    "funnelExtractedData": {},
    "funnelSummary": "<string>",
    "tokenUsage": {
      "cumulativeInputTokens": 123,
      "cumulativeOutputTokens": 123,
      "cumulativeTotalTokens": 123,
      "cumulativeUsd": 123,
      "lastTurnInputTokens": 123,
      "lastTurnOutputTokens": 123,
      "lastTurnTotalTokens": 123,
      "lastTurnUsd": 123,
      "lastTurnModelId": "<string>",
      "lastTurnContextWindow": 123,
      "lastTurnInputUsdPer1k": 123,
      "lastTurnOutputUsdPer1k": 123,
      "lastTurnTs": 123,
      "usagePerModel": {}
    },
    "title": "<string>",
    "lastMessage": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.convocore.ai/llms.txt

Use this file to discover all available pages before exploring further.

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": "john@example.com",
    "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
​
convoId
string
required

Response

Successful response

​
success
boolean
required
​
message
string
required
​
data
object