List sales-agent leads (metadata only)

GET 
/api/v1/chatbots/:chatbotId/sales-agent/leads

Lists a chatbot's captured sales-agent leads over the requested window. Returns METADATA ONLY — disposition, handoff status, country code, timestamps, coarse attribution, and disposition/country aggregates. NO decrypted PII (name/email/phone/custom capture fields, city, region, IP) is exposed by this list. Owner/admin gated (mirrors the dashboard leads view — CRM-sensitive disposition labels are not readable by domain-grant viewers). Required scope: analytics:read.

Request

Responses

200

Lead metadata list + disposition/country aggregates for the chatbot.

400

Bad Request — invalid input

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

404

Not Found

429

Too Many Requests — rate limit exceeded