Skip to main content
GET
List Lead Insights

Authorizations

X-API-Key
string
header
required

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

Path Parameters

id
string
required

Lead id (same id returned by GET /api/leads), as a string path segment — e.g. "42".

Response

Lead insights for the lead (empty array if none yet).

_id
string
required

Preference document id.

leadId
string
required

Lead id these insights belong to.

topic
string
required

Preference domain (e.g. budget, timeline, location).

Maximum string length: 100
preference
string
required

Extracted value for the topic.

Maximum string length: 200
confidence
enum<string>
required

Model confidence in the extraction.

Available options:
high,
medium,
low
accountId
string

Owning account id.

conversationId
string

Conversation that last wrote or updated this insight.

source
string

Short snippet or provenance of the extraction.

createdAt
string<date-time>
updatedAt
string<date-time>
expiresAt
string<date-time>

TTL expiry (default ~90 days from last write).