---
title: "List contact tasks"
method: GET
path: "/contact/{contactId}/task/list"
tags: ["Contact Task"]
---

# List contact tasks

`GET /contact/{contactId}/task/list`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/contact/{contactId}/task/list`
- Auth: HTTP bearer

## Path parameters

- `contactId` string, required: The ID of the contact to list tasks for

## Query parameters

- `cursor` string: The cursor to use for pagination
- `order` 'asc' | 'desc': The order of the paginated items
- `take` integer: The number of items to retrieve

## Response `200`

The list of tasks was retrieved successfully

- object
  - `items` object[], required
    - `name` string: The associated name
    - `description` string: The associated description
    - `meta` Meta: Meta data information
    - `id` string, required: The instance ID
    - `createdAt` number, required: The timestamp (ms) when the instance was created
    - `updatedAt` number, required: The timestamp (ms) when the instance was updated
    - `contactId` string: The contact id assigned to this task
    - `botId` string: The bot associated with the task
    - `schedule` string: The schedule of the task
    - `timezone` string, nullable: The IANA timezone identifier used to evaluate the task schedule.
    - `sessionDuration` number, nullable: The session duration of the task execution (in milliseconds)
    - `maxIterations` number: The maximum number of iterations per task execution
    - `maxTime` number: The maximum time per task execution (in milliseconds)
    - `status` 'idle' | 'running' | 'canceled': The task execution status
    - `outcome` 'pending' | 'success' | 'failure': The task execution outcome
    - `lastRunAt` number, nullable: The timestamp (ms) of the last task execution
    - `nextRunAt` number, nullable: The timestamp (ms) of the next scheduled task execution
  - `cursor` string, required: Cursor for fetching the next page

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)