Skip to main content
GET
Retrieve a conversation

Authorizations

Authorization
string
header
required

Your secret key (pep_sk_…) from Settings → API. Keys are org-scoped; treat them like passwords.

Path Parameters

id
integer
required

Response

The conversation.

object
string
required
Allowed value: "conversation"
id
integer
required
agent
string
required
status
enum<string>
required
Available options:
active,
completed,
abandoned,
disqualified
created_at
string<date-time>
required
messages
object[]
required
captured_answers
object[]
required
assessment
object
required

The lead assessment ({} until assessed).

fit_verdict
enum<string> | null
Available options:
fit,
partial,
no_fit
title
string | null
summary
string | null
locale
string | null
locale_source
enum<string> | null

How the language was set: detected from the visitor words, or chosen from the widget language menu (which outranks detection); null when only the interface hint applied.

Available options:
detected,
chosen,
null
current_phase
string | null
started_at
string<date-time> | null
ended_at
string<date-time> | null
reopened_at
string<date-time> | null

Last time the visitor resumed this conversation after an idle abandonment (idle-abandoned conversations reopen for 7 days).

reopen_count
integer

How many times the visitor resumed it after an idle abandonment.

deliverable
object | null