---
title: "Get Observability Conversation"
method: GET
path: "/v1/observability/conversations/{conversation_id}"
tags: ["Observability Conversations"]
---

# Get Observability Conversation

`GET /v1/observability/conversations/{conversation_id}`

One conversation, with its transcript and how every metric scored it.

The metric results come back alongside, because the reason for opening a
single conversation is almost always that a metric flagged it.

## Path parameters

- `conversation_id` string, uuid, required

## Query parameters

- `include_transcript` boolean

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- ConversationDetailResponse
  - `conversation` ObsConversation, required — Observability conversation, persisted to the Postgres `obs_conversations` table (source of truth, dual-written alongside `calls`, obs_conversation_id == calls.id).
    - `obs_conversation_id` string, uuid, required
    - `created_at` string, date-time, nullable
    - `organization_id` string, uuid, required
    - `agent_id` integer, required
    - `label_id` string, uuid, nullable
    - `status` 'INITIALIZING' | 'QUEUED' | 'READY' | 'DISPATCHED' | 'RUNNING' | 'CONVERSATION_ENDED' | 'EVALUATING' | 'COMPLETED' | 'NO_CONNECTION' | 'NO_ANSWER' | 'CALL_DROPPED' | 'OUT_OF_FUNDS' | 'SYSTEM_ERROR' | 'CUSTOM_ERROR' | 'CANCELLED' | 'INCOMPLETED' | 'REJECTED' | 'INSUFFICIENT_FUNDS' — Enum representing the possible states of a conversation.
    - `multichannel_requested` boolean, nullable
    - `tool_calls` ConversationToolCalls[], nullable
      - `tool_name` string
      - `start_offset_ms` integer
      - `tool_input` object
      - `tool_output` string
    - `initiation_direction` 'INBOUND' | 'OUTBOUND' — Enum representing the direction of a call.
    - `tags` string[], nullable
    - `interface` 'PHONE' | 'WEB' — Enum representing the interface used for a call.
    - `metadata` object, nullable
    - `events` Event[], nullable
      - `title` string, required — Title of the event
      - `start_offset_ms` integer, required — Start offset of the event in milliseconds
      - `description` string, nullable — Description of the event
      - `end_offset_ms` integer, nullable — End offset of the event in milliseconds
      - `tags` string[], nullable — List of tags associated with the event
      - `metadata` object, nullable — Additional metadata associated with the event
    - `conversation_ended_by` 'AGENT' | 'USER' | 'DIGITAL_HUMAN' | 'agent' | 'digital_human' — Role of a participant in a call or simulated conversation.
    - `trace_ids` string[]
    - `start_time_utc` string, date-time, nullable
    - `duration_ms` integer, nullable
    - `participants` Participant[], nullable
      - `role` 'AGENT' | 'USER' | 'DIGITAL_HUMAN' | 'agent' | 'digital_human' — Role of a participant in a call or simulated conversation.
      - `name` string, nullable
      - `spoke_first` boolean
      - `phone_number` string, nullable
    - `submitted_recording_url` string, nullable
    - `submitted_transcript_url` string, nullable
    - `submitted_transcript` TranscriptEntry[], nullable
      - `start_offset_ms` integer, required
      - `end_offset_ms` integer, required
      - `speaker` string, required
      - `utterance` string, required
      - `filler_utterance` boolean, nullable
    - `bluejay_recording_filepath` string, nullable
    - `bluejay_transcript_filepath` string, nullable
    - `bluejay_transcript` object[], nullable
    - `bluejay_translated_transcript` object[], nullable
    - `bluejay_words_transcript` object[], nullable
    - `bluejay_reference_transcript` object[], nullable
    - `bluejay_translated_transcript_filepath` string, nullable
    - `bluejay_words_transcript_filepath` string, nullable
    - `bluejay_reference_transcript_filepath` string, nullable
    - `error_code` string, nullable
    - `error_message` string, nullable
    - `error_details` object, nullable
  - `transcript` object[]
  - `tool_calls` object[]
  - `metric_results` object[]
  - `error_code` string, nullable
  - `error_message` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/4ef94eeb836d/schema)