Skip to main content
GET

Overview

This endpoint retrieves comprehensive details about a conversation, including status, transcript, analysis, and metadata. Use this to fetch conversation data after a call has been completed or while it’s in progress.

Authentication

string
required
Your eigi.ai API key. Must be prefixed with vk_.

Path Parameters

string
required
The unique identifier (UUID format) of the conversation to retrieve.Example: 35d33a43-176c-405c-92bf-db972035df28

Response

string
ID of the agent that handled this conversation
string
Unique identifier (UUID) for the conversation
string
Type of conversation: DAILY, TELEPHONY, WHATSAPP, or CHAT
array | null
AI-generated analysis of the conversation. Returns null if analysis hasn’t been performed yet.
string
Current status: IN_PROGRESS, COMPLETED, DISCONNECTED, or FAILED
string | null
Additional notes or annotations for the conversation
array | null
Array of conversation messages. Each message contains: - role: user or assistant - content: The message text - timestamp: ISO 8601 timestamp
string | null
User ID who created/initiated the conversation
object
Metadata associated with the conversation. For CHAT type includes last_activity and session_status. For TELEPHONY includes to_mobile_number, from_mobile_number, calling_type, telephony_provider, conversation_recording_url, and conversation_duration.
datetime
Timestamp when the conversation was created
datetime
Timestamp of the last update to the conversation
string
Internal MongoDB document ID

Error Responses

Status Codes

Use Cases

After initiating an outbound call, use this endpoint to fetch the complete transcript, analysis, and outcome of the conversation.
Check the status and real-time transcript of ongoing conversations to monitor agent performance.
Pull conversation data for analytics, reporting, or integration with CRM systems.
Review conversation transcripts and analysis for quality assurance and agent training purposes.

Notes

  • Only conversations associated with agents owned by the API key holder can be accessed
  • Conversation data is retained for 90 days by default (configurable in settings)
  • Real-time transcripts are available for ongoing conversations
  • Analysis data is generated automatically after conversation completion

Authorizations

X-API-Key
string
header
required

API key for authentication. Get your API key from the eigi.ai Dashboard under Settings → API Keys.

Path Parameters

conversation_id
string
required

The unique identifier (UUID format) of the conversation to retrieve

Response

Successfully retrieved conversation

conversation_id
string

Unique identifier for the conversation

agent_id
string

ID of the agent that handled this conversation

conversation_type
enum<string>

Type of conversation

Available options:
DAILY,
TELEPHONY,
WHATSAPP,
CHAT
conversation_status
enum<string>

Current status of the conversation

Available options:
IN_PROGRESS,
COMPLETED,
DISCONNECTED,
FAILED
calling_type
enum<string>

Direction of the call

Available options:
INBOUND,
OUTBOUND
mobile_number
string

Phone number involved in the conversation

duration
number

Total duration of the conversation in seconds

created_at
string<date-time>

Timestamp when the conversation was created

updated_at
string<date-time>

Timestamp of the last update

transcript
object[]

Array of conversation messages

analysis
object

AI-generated analysis of the conversation

metadata
object

Custom metadata