Get lead detail

One lead of the API key owner's organization: every field with its type and validity, linked contacts, assigned agents, linked conversation threads (with their inbox row) and the 5 latest notes. POST /crm-lead/import (single) returns the same shape.

lead_id is required (9002 if missing). It is trimmed and not case-sensitive.

A malformed id, a deleted lead, or a lead of another organization → 9032 (not found).

fields lists every lead field that has a value; flag_valid: false means the stored value doesn't fit the field's type.

threads[].inbox has the same shape as the Chronox inbox (channel, last message, agents, tickets...); it is null for a thread with no messages yet.

latest_notes is newest first, at most 5; note_count is the total number of notes.

Access

The route crm-lead/detail GET must be in api_allowed_routes (else 9020); the user's role needs the crm-lead.read permission (else -403).

Errors

Code	Meaning
9002	lead_id missing
9032	Lead not found (malformed id, deleted, or another organization's)
9647	CRM is not enabled for the organization
9028	Database error
9020	Route not allowed for API keys (HTTP 403)
9243	Invalid or expired API key (HTTP 401)
-403	Role lacks crm-lead.read (HTTP 403)
9999	Rate limit exceeded (HTTP 429)

{ "status": true, "data": { "lead_id": "3f6c2a8e-1b4d-4c1e-9a7b-2d5e8f0a1c34", "lead_source_type": { "lead_source_type_id": "b1e2c3d4-0000-4000-8000-000000000001", "lead_source_type_name": "API" }, "lead_origin_type": { "lead_origin_type_id": "d4e5f6a7-0000-4000-8000-000000000003", "lead_origin_type_name": "API" }, "lead_status": { "lead_status_id": "c2d3e4f5-0000-4000-8000-000000000002", "lead_status_name": "New", "lead_status_color": "#2F80ED" }, "fields": [ { "lead_field_id": "d3e4f5a6-0000-4000-8000-000000000003", "lead_field_name": "Name", "lead_field_type_name": "String", "flag_required": true, "flag_system": true, "value": "Ravi Patel", "flag_valid": true }, { "lead_field_id": "e4f5a6b7-0000-4000-8000-000000000004", "lead_field_name": "Email", "lead_field_type_name": "Email", "flag_required": false, "flag_system": false, "value": "ravi.patel@example.com", "flag_valid": true } ], "contacts": [ { "contact_id": 5678, "first_name": "Ravi", "last_name": "Patel", "phone": "919876543210" } ], "agents": [ { "lead_agent_assignment_id": "a1b2c3d4-0000-4000-8000-000000000010", "agent_user_assignment_id": 205, "first_name": "Neha", "last_name": "Shah", "email": "neha.shah@example.com", "timestamp_assigned": "2026-10-23T06:15:00.000Z" } ], "threads": [ { "lead_thread_assignment_id": "b2c3d4e5-0000-4000-8000-000000000011", "thread_id": "c3d4e5f6-0000-4000-8000-000000000012", "flag_primary": true, "linked_at": "2026-10-23T06:20:00.000Z", "inbox": null } ], "latest_notes": [ { "lead_note_id": "d4e5f6a7-0000-4000-8000-000000000013", "lead_id": "3f6c2a8e-1b4d-4c1e-9a7b-2d5e8f0a1c34", "user_assignment_id": 205, "lead_note_value": "Asked for a callback on Monday.", "timestamp": "2026-10-23T07:00:00.000Z", "created_at_timestamp": "2026-10-23T07:00:00.000Z", "first_name": "Neha", "last_name": "Shah" } ], "note_count": 1, "created_by_user_assignment_id": 101, "created_at_timestamp": "2026-10-23T05:00:00.000Z", "timestamp": "2026-10-23T05:00:00.000Z" } }

Request

Responses