Skip to main content
GET
Get a conversation
Use the numeric run ID returned by List conversations. A run outside the requested workspace is reported as 404. Recording and transcript URLs, duration, outcome, and other artifacts can be absent while processing or when that artifact was not collected. Check can_review before offering review controls. Treat returned artifact URLs as sensitive and avoid persisting them as permanent public links.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Path Parameters

run_id
integer
required

Response

Successful Response

agent_name
string
required
channel
enum<string>
required
Available options:
phone,
web,
chat
created_at
string<date-time>
required
id
integer
required
name
string
required
state
string
required
workflow_id
integer
required
called_number
string | null
caller_number
string | null
campaign_id
integer | null
can_review
boolean
default:false
cost_usd
number | null
direction
string | null
duration_seconds
number | null
end_reason
string | null
events
Events · object[]
outcome
string | null
recording_started_at
string | null
recording_url
string | null
review
ConversationReview · object
transcript_url
string | null
variables
Variables · object
version
integer | null