---
title: "Get a single lead’s full profile"
method: GET
path: "/api/v1/leads/{id}"
tags: ["Leads"]
---

# Get a single lead’s full profile

`GET /api/v1/leads/{id}`

## Request

- Base URL: `https://app.reachium.io`
- URL: `https://app.reachium.io/api/v1/leads/{id}`
- Auth: HTTP bearer

`leads` is a global table; a lead existing does not mean this workspace may see it. Entitlement requires either a workspace_leads row or a campaign_lead_progress row via one of this workspace’s campaigns; neither existing 404s identically to the lead id not existing at all (no cross-tenant existence leak).

## Path parameters

- `id` 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`: id 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 such lead, or this workspace is not entitled to see it (code not_found).
- `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/11682826692b?raw)