Get a lead

The lead card: fields, linked contact and company, tasks and notes.

GET https://cotlet.dev/api/v1/kommo/leads/{lead_id}

read

Returns what the lead card shows: stage, sale amount, responsible user, tags, the linked contact and company, open tasks and the latest notes, newest first. Use it before writing to a lead so the write fits what is already there. A lead you have no right to see returns APP_PERMISSION_DENIED.

Parameters

Parameters: get_lead
NameTypeDescription
lead_id integer required integer Lead ID from list_leads or get_lead.

Request

cURL
curl https://cotlet.dev/api/v1/kommo/leads/1 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("kommo", "get_lead", {"lead_id":1})
Node.js
const result = await cotlet.call('kommo', 'get_lead', {"lead_id":1});
CLI
cotlet call kommo get_lead --data '{"lead_id":1}'

Example response

JSON

{
  "lead_id": 24518301,
  "name": "Yoga studio booking",
  "stage": "Proposal",
  "sale": 750,
  "responsible": {
    "user_id": 9102334,
    "name": "Anna Berg"
  },
  "tags": [
    "website"
  ],
  "contact": {
    "contact_id": 1180442,
    "name": "Ana Lopez"
  },
  "company": {
    "company_id": 660201,
    "name": "Lotus Yoga"
  },
  "tasks": [],
  "notes": [
    {
      "text": "Sent proposal for 4 sessions a month.",
      "created_at": "2026-10-12T11:02:00+02:00"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.