Skip to main content
GET
Error

Authorizations

X-API-Key
string
header
required

API key for programmatic access (format nl_live_* or nl_test_*)

Query Parameters

status
enum<string>

Filter conversations by status.

Available options:
active,
completed,
handed_off,
dropped

Search conversations by lead phone, email, or message content (max 100 characters).

Maximum string length: 100

Response

A list of conversations.

_id
string
required

MongoDB ObjectId of the conversation.

Example:

"665f1a2b3c4d5e6f7a8b9c0d"

leadId
string
required

The ID of the associated lead.

accountId
string
required

MongoDB ObjectId of the account (tenant).

agentConfigId
string
required

MongoDB ObjectId of the agent configuration used.

channel
enum<string>
required

The messaging channel used for this conversation.

Available options:
whatsapp,
telegram,
email
leadPhone
string
required

The lead's phone number.

status
enum<string>
required

Current status of the conversation.

Available options:
active,
completed,
handed_off,
dropped
currentStageIndex
integer
required

Index of the current conversation stage.

messages
object[]
required

Ordered list of messages in the conversation.

messageCount
integer
required

Total number of messages in the conversation.

createdAt
string<date-time>
required

When the conversation was created.

updatedAt
string<date-time>
required

When the conversation was last updated.

campaignId
string

MongoDB ObjectId of the campaign, if conversation was started by a campaign.

leadEmail
string

The lead's email address.

currentStageName
string

Name of the current conversation stage.

summary
string

LLM-generated summary of the conversation.

qualificationResult
object