Skip to main content
GET
List Conversations

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
page
integer
default:1
Required range: x >= 1
limit
integer
default:25
Required range: 1 <= x <= 100
sortBy
enum<string>
default:updatedAt
Available options:
updatedAt,
createdAt,
status
sortOrder
enum<string>
default:desc
Available options:
asc,
desc
updatedAfter

Return only conversations with updatedAt strictly after this timestamp. Accepts ISO 8601 (2026-06-01T00:00:00Z) or Unix epoch (seconds or milliseconds).

Example:

"2026-06-01T00:00:00Z"

updatedBefore

Return only conversations with updatedAt strictly before this timestamp. Same formats as updatedAfter.

Example:

"2026-07-01T00:00:00Z"

Response

Paginated conversation list.

conversations
object[]
required
total
integer
required
page
integer
limit
integer