---
title: "Fetch task"
method: GET
path: "/task/{taskId}/fetch"
tags: ["Task"]
---

# Fetch task

`GET /task/{taskId}/fetch`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/task/{taskId}/fetch`
- Auth: HTTP bearer

## Path parameters

- `taskId` string, required: The ID of the task to retrieve

## Response `200`

The task was retrieved successfully

- object: Instance list properties
  - `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
  - `blueprintId` string: The blueprint associated with the task
  - `contactId` string: The contact associated with the 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
  - `expiresAt` number, nullable: The timestamp (ms) at which the task expires and is automatically deleted

## 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)