List | Phonic

from phonic import Phonic
client = Phonic(
    api_key="YOUR_TOKEN_HERE",
)
client.conversations.list()

{
  "conversations": [
    {
      "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,
      "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.01,
      "background_noise": "office",
      "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"
      ],
      "min_words_to_interrupt": 1,
      "default_language": "en",
      "additional_languages": [
        "es"
      ],
      "multilingual_mode": "request",
      "push_to_talk": false,
      "generate_no_input_poke_text": false,
      "no_input_poke_sec": 30,
      "no_input_poke_text": "Are you still there?",
      "no_input_end_conversation_sec": 180,
      "task_results": {},
      "items": [
        {
          "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"
        },
        {
          "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,
          "system_prompt": "You are a helpful {{department}} assistant. The customer's name is {{customer_name}}. Help them book appointments.",
          "tool_calls": [
            {
              "id": "tool_call_a3f8e4b2-7c91-4d63-9b2f-8e5a6c9d1f3a",
              "tool": {
                "id": "tool_check_availability",
                "name": "check_availability"
              },
              "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,
              "request_body": {
                "date": "tomorrow",
                "service": "consultation"
              },
              "response_body": {
                "available": true,
                "slots": [
                  "09:00",
                  "10:00",
                  "14:00"
                ]
              },
              "timed_out": false
            }
          ]
        }
      ],
      "call_info": {
        "from_phone_number": "+15551234567",
        "to_phone_number": "+15559876543"
      },
      "analysis": {
        "latencies_ms": [
          1064,
          578,
          797
        ],
        "interruptions_count": 0
      }
    }
  ],
  "pagination": {
    "next_cursor": "conv_98765432-abcd-1234-5678-abcdef123456"
  }
}

Returns conversations with optional filtering.

Authentication

AuthorizationBearer

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

Bearer authentication header of the form `Bearer <PHONIC_API_KEY>`. Manage your API keys [here](https://phonic.co/api-keys).

Query parameters

projectstringOptionalDefaults to main

The name of the project to list conversations for.

external_idstringOptional

Filter by external ID to get a specific conversation.

duration_minintegerOptional>=0

Minimum duration in seconds.

duration_maxintegerOptional>=0

Maximum duration in seconds.

started_at_minstringOptional

Minimum start date/time. Valid examples: 2025-04-17, 2025-04-17T02:48:52.708Z

started_at_maxstringOptional

Maximum start date/time. Valid examples: 2025-04-17, 2025-04-17T02:48:52.708Z

beforestringOptional

Cursor for backward pagination. Use a conversation ID from pagination.prev_cursor to fetch the previous page of conversations. Cannot be used with after.

afterstringOptional

Cursor for forward pagination. Use a conversation ID from pagination.next_cursor to fetch the next page of conversations. Cannot be used with before.

limitintegerOptional1-100Defaults to 20

Maximum number of conversations to return per page.

audio_containerenumOptionalDefaults to wav.gz

Format of the presigned audio_url in each conversation in the response.

Allowed values:

Response

Paginated list (conversations, pagination) when listing, or a single conversation when the external_id query parameter matches exactly one conversation.

ListConversationsResponseobject

GetConversationByExternalIdResponseobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error