---
title: "Get a lead"
method: GET
path: "/leads/{id}"
tags: ["Leads"]
---

# Get a lead

`GET /leads/{id}`

Get a single lead by the ID provided.

## Path parameters

- `id` string, required

## Response `200`

Lead

- LeadDetailResponse — A full response object for a detailed lead endpoint.
  - `meta` Meta, required — Information about the Nutshell instance making the request
    - `instanceId` string — The Nutshell instance ID
    - `siteId` string — Site ID for WebFX customers
  - `links` object, required
  - `leads` LeadDetail[], required
    - `htmlUrl` string — The link to the entity within the app.
    - `htmlUrlPath` string — The path to the entity within the app.
    - `avatarUrl` string — The URL of the entity's avatar image.
    - `initials` string — The initials of the entity, used as a fallback for the avatar image.
    - `id` string — The API ID of this entity, formatted {integer}-{entityType}
    - `deletedTime` string
    - `name` string — The full name of the lead
    - `value` Value
      - `formatted` string — The value formatted as a string
      - `amount` string — The value as a number
      - `currency` string — The currency code
    - `number` integer
    - `description` string
    - `createdTime` CreatedTime — When the lead was created.
      - `absoluteLocalizedString` string — The value formatted as a string
      - `timestamp` number
      - `value` string — The value to be formatted
    - `closedTime` string
    - `dueTime` string
    - `anticipatedClosedTime` string
    - `ownerType` string
    - `status` string — The current status of the lead
    - `lastContactedTime` unknown
    - `pieState` string
    - `isOverdue` boolean — Whether the lead is overdue to have a final outcome set
    - `overdueTime` string
    - `href` string
    - `confidence` integer — How confident, as a percentage, that the lead will close
    - `priority` integer — Whether a lead is marked as hot (1) or not (0)
    - `isCurrentUserWatching` boolean — Whether the current authenticated user is subscribed to receive notifications about this lead
    - `attributionTracking` LeadAttributionTracking, required — System-managed click identifiers captured for lead attribution.
      - `gclid` string[], required
      - `fbclid` string[], required
      - `msclkid` string[], required
      - `lifatid` string[], required
      - `wbraid` string[], required
      - `gbraid` string[], required

## Changes

- **2026-08-24** `f0f3f6f3b9b2` — 1 breaking, 4 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/Lead, #/components/schemas/HtmlLinkable, #/components/schemas/Avatarable` from the response body `allOf` list for the response status `200`
  - added the required property `leads` to the response with the `200` status
  - added the required property `links` to the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/nutshell/apis/nutshell-api/changes/leads/:id/get.md)

---

[API](https://skmtc.dev/nutshell/apis/nutshell-api.md) · [All operations](https://skmtc.dev/nutshell/apis/nutshell-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nutshell/nutshell-api/revisions/14f59cf6a09a/schema)