---
title: "Resolve the lead attached to a campaign-driven conversation"
method: GET
path: "/api/v1/conversations/{chatId}/lead"
tags: ["Conversations", "Leads"]
---

# Resolve the lead attached to a campaign-driven conversation

`GET /api/v1/conversations/{chatId}/lead`

## Request

- Base URL: `https://app.reachium.io`
- URL: `https://app.reachium.io/api/v1/conversations/{chatId}/lead`
- Auth: HTTP bearer

Organic Unibox conversations with no campaign_lead_progress row 404 with `no_lead_for_chat` rather than a bare not_found, since "this chat has no lead" is an expected, common state here.

## Path parameters

- `chatId` string, required

## Response `200`

The lead’s full profile plus workspace-scoped state.

- object
  - `data` LeadProfile, required
    - `id` string, required
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
    - `name` string, nullable, required
    - `linkedin_url` string, nullable, required
    - `job_title` string, nullable, required
    - `headline` string, nullable, required
    - `company_name` string, nullable, required
    - `location` string, nullable, required
    - `email` string, nullable, required
    - `tags` string[], nullable, required
    - `notes` string, nullable, required
    - `custom_fields` object, nullable, required
    - `added_at` string, date-time, nullable, required
  - `error` unknown, required

## Other responses

- `400`: chatId is required (code invalid_request).
- `401`: Missing or invalid API key. Send `Authorization: Bearer rmcp_...` (code unauthorized).
- `403`: The key's granted scopes do not satisfy this endpoint's minimum required scope (code insufficient_scope).
- `404`: No lead is attached to this conversation, or it belongs to another workspace (code no_lead_for_chat).
- `429`: Rate limited: shared `mcp:ip:{ip}` (600/60s) or `mcp:key:{keyId}` (120/60s) bucket, the SAME buckets the MCP endpoint uses (code rate_limited).
- `500`: Lookup failed (code lookup_failed).

---

[API](https://skmtc.dev/reachium/apis/reachium-api.md) · [All operations](https://skmtc.dev/reachium/apis/reachium-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reachium/apis/reachium-api/revisions/30c16b30b499?raw)