---
title: "Get one API-visible lead."
method: GET
path: "/customer/leads/{leadId}"
tags: ["Customer REST"]
---

# Get one API-visible lead.

`GET /customer/leads/{leadId}`

## Request

- Base URL: `https://api.traxy.ai/api/v1`
- URL: `https://api.traxy.ai/api/v1/customer/leads/{leadId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/docs/customer/leads/:leadId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `leadId` string, uuid, required

## Response `200`

Lead detail.

- object
  - `data` Lead, required
    - `id` string, uuid, required
    - `icpMatchPercent` integer, nullable
    - `intentScore` number
    - `leadTier` string, nullable
    - `profile` object, required
      - `displayName` string, nullable, required
      - `headline` string, nullable, required
      - `location` string, nullable, required
      - `currentCompany` string, nullable, required
      - `profileUrl` string, uri, nullable, required: Canonical LinkedIn profile URL; null without leads:contact_read.
    - `contact` object, nullable, required: Null unless the credential has leads:contact_read.
      - `workEmail` string, email, nullable, required
      - `workEmailStatus` string, nullable, required
      - `personalEmail` string, email, nullable, required
      - `personalEmailStatus` string, nullable, required
      - `contactPhone` string, nullable, required
      - `contactPhoneStatus` string, nullable, required
    - `signal` LeadSignal, required
      - `summary` string, required
      - `whyRelevant` string, required
      - `topic` string, nullable, required
      - `type` 'COMPETITOR' | 'PAIN' | 'TRIGGER' | 'TOPIC' | 'CATEGORY_INTEREST' | 'CUSTOM' | 'GENERAL_ENGAGEMENT', required
      - `strength` 'DIRECT' | 'CONTEXTUAL' | 'ACTIVITY', required
      - `sentiment` 'NEGATIVE' | 'POSITIVE' | 'MIXED' | 'NEUTRAL' | 'UNKNOWN', required
      - `occurredAt` string, date-time, required
      - `source` object, required
        - `name` string, nullable, required
        - `title` string, nullable, required
        - `url` string, nullable, required

## Other responses

- `400`: Request failed boundary validation.
- `401`: Invalid, expired, or revoked API key.
- `402`: Key or OAuth grant lacks the required scope.
- `404`: Resource not found for the key workspace.

## Changes

- **2026-09-24** `3dde15782092`: 12 info
  - added the required property `data/contact/contactPhone` to the response with the `200` status
  - added the required property `data/contact/contactPhoneStatus` to the response with the `200` status
  - added the required property `data/contact/personalEmail` to the response with the `200` status
  - added the required property `data/contact/personalEmailStatus` to the response with the `200` status
  - …8 more
- **2026-07-04** `467b330a307b`: 6 breaking, 8 warning, 5 info
  - the `data/contact` response's property type changed from no type to `object` for status `200`
  - the `data/intentScore` response's property format changed from `float` to no format for status `200`
  - removed the required property `data/profile/currentCompany` from the response with the `200` status
  - removed the required property `data/profile/displayName` from the response with the `200` status
  - …15 more
- **2026-06-12** `f103a3a38e28`: 2 breaking, 4 warning, 11 info
  - added `#/components/schemas/LeadContact` to the `data/contact` response property `oneOf` list for the response status `200`
  - the `data/contact` response's property type changed from `object` to no type for status `200`
  - added the new `NURTURE` enum value to the `data/leadTier` response property for the response status `200`
  - added the new `PRIORITY` enum value to the `data/leadTier` response property for the response status `200`
  - …13 more

[Operation history](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/changes/customer/leads/:leadId/get.md)

---

[API](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1.md) - [All operations](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/revisions/765b1a6a3abd?raw)