---
title: "List activities"
method: GET
path: "/lead/v2/leads/{leadId}/activities"
tags: ["AppResellerLeads"]
---

# List activities

`GET /lead/v2/leads/{leadId}/activities`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/lead/v2/leads/{leadId}/activities`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/lead/v2/leads/:leadId/activities/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a list of all lead activities visible for a given context. You can filter the list using optional query parameters.

## Path parameters

- `leadId` string, required

## Query parameters

- `context` 'RESELLER' | 'REFERRAL' | 'DEVELOPER' | 'RESELLER_MANAGER' | 'PARTNER' | 'ANONYMOUS', required
- `companyId` string, required
- `fromDate` number
- `toDate` number
- `creationDateOrder` 'ASC' | 'DESC'
- `page` integer
- `size` integer

## Response `200`

Success

- LeadActivityPagedReadResponse: Paged response as an array of lead activity objects
  - `page` PageMetadata, required
    - `number` number, required: Page number
    - `size` number, required: Size of the page to be returned
    - `totalElements` number, required: Total number of elements
    - `totalPages` number, required: Total number of pages
  - `content` LeadActivity[], required
    - `id` string, required: Lead activity ID
    - `partner` string, required: Marketplace partner code
    - `createdOn` number, required: Date on which the activity was created, in UNIX Epoch milliseconds
    - `verb` 'LEAD_CREATED' | 'LEAD_UPDATED' | 'LEAD_SUBMITTED' | 'LEAD_ASSIGNED' | 'LEAD_CONVERTED' | 'LEAD_DELETED' | 'LEAD_DISQUALIFIED' | 'LEAD_CONVERSION_REQUESTED' | 'LEAD_CONVERSION_APPROVED' | 'LEAD_MARKED_OPEN' | 'LEAD_MARKED_WON' | 'LEAD_MARKED_LOST' | 'LEAD_ORDER_LINKED' | 'LEAD_ORDER_UNLINKED' | 'LEAD_QUOTE_LINKED' | 'LEAD_QUOTE_UNLINKED' | 'LEAD_PRODUCT_LINKED' | 'LEAD_PRODUCT_UNLINKED' | 'LEAD_COMPANY_ASSOCIATED' | 'LEAD_COMPANY_ASSOCIATION_LOST' | 'LEAD_PRODUCT_DELETED', required: Lead activity action (or verb)
    - `verbContext` 'PRODUCT_PROFILE' | 'RESELLER_PROFILE' | 'COMPANY' | 'MARKETPLACE' | 'SALES_SUPPORT': Lead activity action's context (or verb context)
    - `allowedResourcesAccess` LeadActivityResource[], required: The lead's activity resource (the type of object that the activity refers to)
    - `actorCompany` LeadCompany: Information about the marketplace company related to the lead
      - `id` string, required: Company ID
      - `name` string: Company name
    - `contextCompany` LeadCompany: Information about the marketplace company related to the lead
      - `id` string, required: Company ID
      - `name` string: Company name
    - `contextApplication` LeadProduct: Information about the product related to a lead
      - `id` string, required: Product ID
      - `name` string, required: Product name
      - `provider` string: Marketplace partner code
    - `contextPurchaseOrder` LeadPurchaseOrder: Information about the purchase order linked to the lead
      - `id` number, required: Purchase order ID
    - `contextQuote` LeadQuote: Information about a quote linked to the lead
      - `id` string, required: Quote ID
      - `friendlyId` string, required: Quote ID in friendly format
      - `applicationName` string, required: The product name from the quote

## Other responses

- `401`: Unauthorized
- `404`: Not Found

## Changes

- **2026-11-06** `1fc240f06971`: 1 breaking, 2 info
  - the response's body type changed from no type to `object` for status `200`
  - added the required property `content` to the response with the `200` status
  - added the required property `page` to the response with the `200` status

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/lead/v2/leads/:leadId/activities/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)
