---
title: "Lead Activities"
method: GET
path: "/v1.0/leads/{leadId}/activities"
tags: ["Leads"]
---

# Lead Activities

`GET /v1.0/leads/{leadId}/activities`

Returns the lead's site-tracked activities (browse / search / favorite / showing request / submission) across tracking types 1, 2, 3, 23 and 39, merged and sorted by created time descending.

Notes:
- Caller must have manage permission on the lead; otherwise 404 LEAD_NOT_EXIST.
- Page size is fixed at 100; use curPage to step through pages.

## Path parameters

- `leadId` integer, required

## Query parameters

- `curPage` integer

## Headers

- `Authorization` string, required

## Response `200`

Activities for the lead.

- LeadActivity[]
  - `type` string, required — Specifies the type of activity being logged for the lead. **Accepted Values:** - **Search**: When the lead performs a search operation (e.g., filtering by property type like Single Family Home) - **Browse**: When the lead views a property detail page - **Favorite**: When the lead saves a property to favorites - **Request**: When the lead submits a showing request for a property - **Submission**: When the lead submits a form on website
  - `text` string, required — Search Text
  - `link` string, required — Url for web page
  - `picture` string, required — Preview picture url
  - `listing` LeadProperty — Lead property or mailing address details
    - `price` integer — The price Applies to lead routing only if the leadType field is Seller(1)
    - `state` string — The state Applies to lead routing only if the leadType field is Seller(1)
    - `city` string — The city Applies to lead routing only if the leadType field is Seller(1)
    - `streetAddress` string — The street address Applies to lead routing only if the leadType field is Seller(1)
    - `zipCode` string — The zip code Applies to lead routing only if the leadType field is Seller(1)
    - `county` string — The county Applies to lead routing only if the leadType field is Seller(1)
    - `propertyType` string — Property type: `Single Family Home`, `Multi-Family`, `Condo`, `Townhouse`, `Mobile Home`, `Manufactured Home`, `Vacant Land`, `Commercial`.
    - `bedrooms` integer — The bed rooms.
    - `bathrooms` number, double — The bath rooms.
    - `squareFeet` integer — The square feet.
    - `lotSize` number, double — The lot size (acreage).
    - `parkingSpace` integer — The parking space.
    - `floors` integer — The floors.
    - `mailAddress` boolean — If set to true, the address is a mailing address; otherwise, it is a property address.
    - `id` integer — The property ID. Required when updating an existing mailing address or property address. If not provided, a new address will be created.
    - `leadUserId` integer
    - `listingId` string
    - `autoListingId` integer
    - `label` string
    - `note` string
    - `listingStatus` string
    - `labelList` string
    - `pictureUrl` string
    - `siteListingUrl` string
    - `labelType` string
    - `priceMax` integer — The max price Applies to lead routing only if the leadType field is Seller(1)
    - `priceMin` integer — The min price Applies to lead routing only if the leadType field is Seller(1)
  - `created` integer, required — created time in milliseconds
  - `scheduledDate` string — Scheduled date about this showing request
  - `pageName` string — The page name of the lead's submission(re-inquiry) page

## Other responses

- `401` — Missing or invalid authentication token (BAD_CREDENTIALS).
- `404` — Lead does not exist or caller has no access (20006 LEAD_NOT_EXIST).
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)