---
title: "Get Lead History"
method: GET
path: "/leads/{leadId}/history"
tags: ["leads"]
---

# Get Lead History

`GET /leads/{leadId}/history`

## Request

- Base URL: `https://api.acculynx.com/api/v2`
- URL: `https://api.acculynx.com/api/v2/leads/{leadId}/history`
- Auth: HTTP bearer

Use this endpoint to get a history of actions performed for a lead.

**Supported includes:** `createdBy`.

## Path parameters

- `leadId` string, uuid, required

## Query parameters

- `includes` string

## Response `200`

OK

- LeadActionCollection
  - `items` LeadAction[]
    - `action` string: The action performed on this lead.
    - `date` string: Date and time the action happened represented in UTC.
    - `createdBy` CompanyUserLink
      - `id` string, uuid: The unique GUID of the AccuLynx User.
      - `_link` string: The unique URI of the AccuLynx User.
    - `leadDeadReason` string

## Other responses

- `401`: The API key provided is missing, invalid, or has been deactivated. Verify your API key and try again.
- `404`: The requested resource was not found. Verify the ID in the request path is correct and that the resource exists.

---

[API](https://skmtc.dev/acculynx/apis/acculynx-api-v2.md) - [All operations](https://skmtc.dev/acculynx/apis/acculynx-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/acculynx-api-v2/revisions/443924b00f43?raw)