Get | Phonic

{
  "conversation": {
    "id": "conv_12cf6e88-c254-4d3e-a149-ddf1bdd2254c",
    "agent": {
      "id": "agent_12cf6e88-c254-4d3e-a149-a7f1bdd22783",
      "name": "support-agent",
      "is_deleted": false
    },
    "workspace": "example-workspace",
    "project": {
      "id": "proj_ad0334f1-2487-4155-9df3-abd8129b29ad",
      "name": "customer-support"
    },
    "external_id": "call-123",
    "origin": "inbound",
    "model": "merritt",
    "generate_welcome_message": false,
    "is_welcome_message_interruptible": true,
    "listen_only": false,
    "welcome_message": "Hello {{customer_name}}, this is the {{department}} team. How can I help you today?",
    "template_variables": {
      "customer_name": "John",
      "department": "Support"
    },
    "input_format": "mulaw_8000",
    "output_format": "mulaw_8000",
    "background_noise_level": 0,
    "background_noise": null,
    "live_transcript": "User: Hi, I need help with booking an appointment.\nAssistant: Of course! I'd be happy to help you book an appointment.",
    "post_call_transcript": "User: Hi, I need help with booking an appointment.\nAssistant: Of course! I'd be happy to help you book an appointment.",
    "duration_ms": 120500,
    "audio_url": "https://example.com/audio/conv_12cf6e88.wav",
    "started_at": "2025-07-30T23:45:00.000Z",
    "ended_at": "2025-07-30T23:47:00.500Z",
    "ended_by": "user",
    "boosted_keywords": [
      "Load ID",
      "dispatch"
    ],
    "pronunciation_dictionary": [
      {
        "word": "Phuket",
        "pronunciation": "Poo-ket"
      }
    ],
    "min_words_to_interrupt": 1,
    "default_language": "en",
    "additional_languages": [
      "es"
    ],
    "multilingual_mode": "request",
    "push_to_talk": false,
    "no_input_poke_sec": 30,
    "no_input_poke_text": "Are you still there?",
    "no_input_end_conversation_sec": 180,
    "task_results": {},
    "items": [
      {
        "id": "string",
        "item_idx": 0,
        "role": "user",
        "live_transcript": "Hi, I need help with booking an appointment.",
        "post_call_transcript": "Hi, I need help with booking an appointment.",
        "duration_ms": 2500,
        "started_at": "2025-07-30T23:45:00.000Z"
      },
      {
        "id": "string",
        "item_idx": 1,
        "role": "assistant",
        "live_transcript": "Of course! I'd be happy to help you book an appointment.",
        "post_call_transcript": "Of course! I'd be happy to help you book an appointment.",
        "duration_ms": 3000,
        "started_at": "2025-07-30T23:45:02.500Z",
        "voice_id": "sabrina",
        "audio_speed": 1,
        "tool_calls": [
          {
            "id": "tool_call_f2d5c8a1-9e4b-4a7c-b3d1-6f8e2a9c5b7d",
            "tool": {
              "id": "tool_check_availability",
              "name": "check_availability"
            },
            "request_body": {
              "date": "tomorrow",
              "service": "consultation"
            },
            "response_body": {
              "available": true,
              "slots": [
                "09:00",
                "10:00",
                "14:00"
              ]
            },
            "timed_out": false,
            "error_message": null,
            "endpoint_method": "POST",
            "endpoint_url": "https://api.example.com/tools/check_availability",
            "endpoint_headers": {
              "Authorization": "Bearer token123"
            },
            "endpoint_timeout_ms": 5000,
            "endpoint_called_at": "2025-07-30T23:45:03.000Z",
            "query_params": {},
            "response_status_code": 200,
            "tool_call_output_timeout_ms": null
          }
        ],
        "system_prompt": "You are a helpful {{department}} assistant. The customer's name is {{customer_name}}. Help them book appointments."
      }
    ],
    "call_info": {
      "from_phone_number": "+15551234567",
      "to_phone_number": "+15559876543"
    },
    "analysis": {
      "id": "string",
      "latencies_ms": [
        1064,
        578,
        797
      ],
      "interruptions_count": 0
    },
    "vad_prebuffer_duration_ms": 500,
    "vad_min_speech_duration_ms": 50,
    "vad_min_silence_duration_ms": 800,
    "vad_threshold": 0.38
  }
}

Returns a conversation by ID.

Authentication

AuthorizationBearer

Bearer authentication header of the form Bearer <PHONIC_API_KEY>. Manage your API keys here.

Path parameters

idstringRequired

The ID of the conversation to get.

Query parameters

audio_containerenumOptionalDefaults to wav.gz

Format of the presigned audio_url in the response.

Allowed values:

Response

Success response

conversationobject

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error