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

# List tasks

`GET /dealerships/{dealershipId}/tasks`

## Request

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

Returns a paginated list of tasks with optional filtering.

By default, only non-deleted tasks (where `deleted_at` is null) are returned. Use the `trashed` parameter to include or filter deleted tasks.

Additional fields can be included in the response using the `embed` parameter. Available embed options:
- `activities` - Array of activities associated with the task
- `notes` - Array of task notes
- `shopper` - Shopper object associated with the task

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

## Path parameters

- `dealershipId` integer, required

## Query parameters

- `assigned_to` integer
- `status` 'pending' | 'in_progress' | 'completed' | 'cancelled'
- `priority` 'low' | 'medium' | 'high'
- `due_date_from` string, date
- `due_date_to` string, date
- `trashed` 'with' | 'only' | 'without'
- `embed` string
- `page` integer
- `per_page` integer
- `sort` string

## Response `200`

A paginated list of tasks

- TasksResponse: Response containing multiple tasks with pagination info
  - `data` Task[], required
    - `id` integer, required: Unique task identifier
    - `shopper_id` integer, nullable: Identifier of the shopper associated with this task
    - `created_by` integer, nullable: User ID of the user who created the task
    - `assigned_to` integer, nullable: User ID assigned to the task
    - `type` string, required: Type of task
    - `title` string, required: Task title
    - `description` string, nullable: Task description
    - `priority` 'low' | 'medium' | 'high', nullable: Priority level of the task
    - `status` 'pending' | 'in_progress' | 'completed' | 'cancelled', required: Current status of the task
    - `department` string, nullable: Department associated with the task
    - `due_date` string, date, nullable: Due date for the task (YYYY-MM-DD)
    - `created_at` string, date-time, required: ISO 8601 creation timestamp
    - `updated_at` string, date-time, required: ISO 8601 last update timestamp
    - `deleted_at` string, date-time, nullable: ISO 8601 deletion timestamp (soft delete)
    - `activities` Activity[]: Embedded activities (when using ?embed=activities)
      - `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)
    - `notes` TaskNote[]: Embedded task notes (when using ?embed=notes)
      - `id` integer, required: Unique task note identifier
      - `task_id` integer, required: Identifier of the task this note belongs to
      - `content` string, required: Content of the note
      - `profile_id` integer, nullable: User ID of the profile who created the note
      - `created_at` string, date-time, nullable: ISO 8601 creation timestamp
      - `updated_at` string, date-time, nullable: ISO 8601 last update timestamp
      - `profile` object, nullable: Embedded profile object (when using ?embed=profile)
    - `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 tasks 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)