Conversations

Every voice session is automatically logged as a conversation with full transcripts, per-turn latency metrics, and metadata.

List Conversations

BASH

# List all conversations (paginated)
curl "https://ultravoice.us.inc/api/v1/conversations/?limit=50&offset=0" \
  -H "Authorization: Bearer $TOKEN"

# Filter by agent
curl "https://ultravoice.us.inc/api/v1/conversations/?agent_id=a1b2c3d4-..." \
  -H "Authorization: Bearer $TOKEN"

# Filter by user
curl "https://ultravoice.us.inc/api/v1/conversations/?user_id=user-123" \
  -H "Authorization: Bearer $TOKEN"

Get Conversation Detail

BASH

curl https://ultravoice.us.inc/api/v1/conversations/{conversation_id} \
  -H "Authorization: Bearer $TOKEN"

JSON

{
  "data": {
    "id": "conv-uuid",
    "agent_id": "agent-uuid",
    "user_id": "user-123",
    "start_time": "2026-01-15T10:00:00Z",
    "end_time": "2026-01-15T10:05:32Z",
    "duration_seconds": 332,
    "turns": [
      {
        "role": "assistant",
        "text": "Hello! How can I help you today?",
        "asr_latency_ms": null,
        "llm_latency_ms": null,
        "tts_latency_ms": 120
      },
      {
        "role": "user",
        "text": "I'd like to check my order status.",
        "asr_latency_ms": 180,
        "llm_latency_ms": null,
        "tts_latency_ms": null
      }
    ]
  }
}

Analytics

BASH

# Provider latency metrics
curl https://ultravoice.us.inc/api/v1/analytics/latency \
  -H "Authorization: Bearer $TOKEN"

# Usage metrics
curl https://ultravoice.us.inc/api/v1/analytics/usage \
  -H "Authorization: Bearer $TOKEN"

# System health
curl https://ultravoice.us.inc/api/v1/analytics/system-health \
  -H "Authorization: Bearer $TOKEN"

# Tool call metrics
curl "https://ultravoice.us.inc/api/v1/analytics/tool-calls?agent_id=AGENT_ID" \
  -H "Authorization: Bearer $TOKEN"