Get call log

Retrieve comprehensive details, transcript, and qualitative summary for a specific call

GET /api/v1/call-logs/{call_log_id}

cURL

curl -X GET "https://api.sayvy.ai/api/v1/call-logs/7b8d8b9e-63f5-46b6-9bb2-15f18731b819" \
  -H "Authorization: Bearer <token>"

200 OK

{
  "id": "7b8d8b9e-63f5-46b6-9bb2-15f18731b819",
  "organization_id": "e0b973dc-13a8-4c9f-861a-03e5b4b1a8d9",
  "call_id": "call_61ef871b0a82",
  "agent_id": "4a1c5d7e-9081-423b-a612-432109876543",
  "whatsapp_phone_number_id": "11a22b33-44c5-5d6e-7f8a-9b0c1d2e3f4a",
  "phone_number_id": "PN1234567890abcdef",
  "from_number": "[phone]",
  "to_number": "[phone]",
  "direction": "inbound",
  "status": "completed",
  "duration_seconds": 142,
  "started_at": "2026-09-07T14:30:00Z",
  "ended_at": "2026-09-07T14:32:22Z",
  "recording_url": "call-recordings/7b8d8b9e-63f5-46b6-9bb2-15f18731b819.ogg",
  "transcript": [
    {
      "speaker": "agent",
      "text": "Hello! Thank you for calling Sayvy AI support. How may I assist you?",
      "timestamp": 0.8
    },
    {
      "speaker": "caller",
      "text": "Hi, I would like to inquire about enterprise pricing for conversational agents.",
      "timestamp": 4.2
    }
  ],
  "summary": "Caller inquired about enterprise pricing models. Agent provided standard tier quotes and scheduled a demo callback.",
  "cost": 0.048,
  "created_at": "2026-09-07T14:29:55Z",
  "updated_at": "2026-09-07T14:32:30Z"
}

Fetch a single call log entry by its unique identifier (call_log_id). The response includes caller numbers, agent metadata, duration in seconds, dialog transcript, summary, and recording reference.

---

Authentication

This endpoint requires Bearer token authentication.

Authorization: Bearer <token>

Header	Type	Required	Description	Format
Authorization	string	Yes	Scoped organization API key or Bearer JWT token	Bearer <token>

---

Path Parameters

Authorization · string · required

Bearer token for authentication. Format: Bearer <token>.

call_log_id · string · required

Unique UUID identifier of the call log entry.

---

Response Fields

id · string

Unique UUID identifier for this call log entry.

organization_id · string

UUID of the owning organization.

call_id · string

Telephony provider call identifier (e.g. call_61ef871b0a82).

agent_id · string

UUID of the voice agent configured to handle this call, or null.

whatsapp_phone_number_id · string

UUID of the organization WhatsApp voice endpoint, or null.

phone_number_id · string

Telephony provider phone number identifier, or null.

from_number · string

Originating caller phone number in E.164 format.

to_number · string

Destination recipient phone number in E.164 format.

direction · string

Call direction (inbound or outbound).

status · string

Call execution status (completed, in-progress, busy, failed, no-answer).

duration_seconds · integer

Duration of the active audio connection in seconds.

started_at · string

ISO 8601 timestamp when call audio channel was connected.

ended_at · string

ISO 8601 timestamp when call was hung up.

recording_url · string

Storage path or identifier to retrieve audio recording via /audio proxy endpoint.

transcript · any

Structured speaker dialog transcript segments.

summary · string

AI-generated qualitative summary of the voice conversation.

cost · number

Calculated total carrier and AI inference cost in USD.

created_at · string

ISO 8601 creation timestamp.

updated_at · string

ISO 8601 last update timestamp.

---

cURL

curl -X GET "https://api.sayvy.ai/api/v1/call-logs/7b8d8b9e-63f5-46b6-9bb2-15f18731b819" \
  -H "Authorization: Bearer <token>"

200 OK

{
  "id": "7b8d8b9e-63f5-46b6-9bb2-15f18731b819",
  "organization_id": "e0b973dc-13a8-4c9f-861a-03e5b4b1a8d9",
  "call_id": "call_61ef871b0a82",
  "agent_id": "4a1c5d7e-9081-423b-a612-432109876543",
  "whatsapp_phone_number_id": "11a22b33-44c5-5d6e-7f8a-9b0c1d2e3f4a",
  "phone_number_id": "PN1234567890abcdef",
  "from_number": "[phone]",
  "to_number": "[phone]",
  "direction": "inbound",
  "status": "completed",
  "duration_seconds": 142,
  "started_at": "2026-09-07T14:30:00Z",
  "ended_at": "2026-09-07T14:32:22Z",
  "recording_url": "call-recordings/7b8d8b9e-63f5-46b6-9bb2-15f18731b819.ogg",
  "transcript": [
    {
      "speaker": "agent",
      "text": "Hello! Thank you for calling Sayvy AI support. How may I assist you?",
      "timestamp": 0.8
    },
    {
      "speaker": "caller",
      "text": "Hi, I would like to inquire about enterprise pricing for conversational agents.",
      "timestamp": 4.2
    }
  ],
  "summary": "Caller inquired about enterprise pricing models. Agent provided standard tier quotes and scheduled a demo callback.",
  "cost": 0.048,
  "created_at": "2026-09-07T14:29:55Z",
  "updated_at": "2026-09-07T14:32:30Z"
}