---
title: "List activities"
method: GET
path: "/dealerships/{dealershipId}/activities"
tags: ["activities"]
---

# List activities

`GET /dealerships/{dealershipId}/activities`

## Request

- Base URL: `https://api.fullpath.com/consent-management`
- URL: `https://api.fullpath.com/consent-management/dealerships/{dealershipId}/activities`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0/docs/dealerships/:dealershipId/activities/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of activities with optional filtering.

Additional fields can be included in the response using the `embed` parameter. Available embed options:
- `shopper` - Shopper object associated with the activity

Multiple embed options can be specified as a comma-separated list, e.g., `embed=shopper`.

## Path parameters

- `dealershipId` integer, required

## Query parameters

- `assigned_to` integer
- `lead_id` integer
- `task_id` integer
- `type` 'call' | 'email' | 'meeting' | 'note' | 'task'
- `start_date` string, date
- `end_date` string, date
- `embed` string
- `page` integer
- `per_page` integer
- `sort` string

## Response `200`

A paginated list of activities

- ActivitiesResponse: Response containing multiple activities with pagination info
  - `data` Activity[], required
    - `id` integer, required: Unique activity identifier
    - `assigned_to` integer, nullable: User ID assigned to the activity
    - `shopper_id` integer, nullable: Identifier of the shopper associated with this activity
    - `task_id` integer, nullable: Identifier of the task associated with this activity
    - `type` 'call' | 'email' | 'meeting' | 'note' | 'task', required: Type of activity
    - `type_id` integer, nullable: Type-specific identifier
    - `title` string, required: Title of the activity
    - `description` string, nullable: Description of the activity
    - `notes` string, nullable: Notes for the activity
    - `status` string, nullable: Status of the activity
    - `created_at` string, date-time, nullable: ISO 8601 creation timestamp
    - `updated_at` string, date-time, nullable: ISO 8601 last update timestamp
    - `shopper` object, nullable: Embedded shopper object (when using ?embed=shopper)
  - `pagination` Pagination, required: Pagination metadata
    - `page` integer, required: Current page number (1-based)
    - `per_page` integer, required: Number of items per page
    - `total` integer, required: Total number of items
    - `total_pages` integer, required: Total number of pages

## Other responses

- `204`: No activities found
- `400`: Invalid query parameters
- `401`: Unauthorized
- `500`: Server error

---

[API](https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0.md) - [All operations](https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/fullpath/apis/fullpath-api-v1-openapi-3-0/revisions/4b73e1835a7e?raw)