Skip to main content
GET
/
agents
/
{agentId}
/
convos
Get Agent Conversations
curl --request GET \
  --url https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos \
  --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 conversations sorted by timestamp (newest first). Empty conversations without essential data are filtered out.
Use page and limit query parameters to paginate large conversation lists efficiently.

​
Query Parameters

ParameterTypeDefaultDescription
pagenumber1Page number for pagination
limitnumber20Number of conversations per page

​
Example Response

{
  "success": true,
  "message": "Conversations 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",
      "notes": "Customer interested in premium plan",
      "tags": ["new-lead"],
      "origin": "web-chat",
      "firstMessageTS": 1699999000,
      "lastMessageTS": 1699999999
    }
  ]
}

​
Response Fields

Each conversation in the array includes:

​
Lead Information

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

​
Conversation Metadata

  • ID, userID - Identifiers
  • messagesNum - Message count
  • tags - Categorization tags
  • origin - Channel (e.g., “web-chat”, “whatsapp”)
  • Timestamps: ts, firstMessageTS, lastMessageTS

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
agentId
string
required

Query Parameters

​
page
number
default:1
​
limit
number
default:20

Response

Successful response

​
success
boolean
required
​
message
string
required
​
data
object[]
required