> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-beta.getzep.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-beta.getzep.com/_mcp/server.

# Get Task

GET https://api.getzep.com/api/v2/tasks/{task_id}

Gets a task by its ID

Reference: https://docs-beta.getzep.com/sdk-reference/task/get-task

## Request

### Path parameters

- `task_id` (string, required) — Task ID

## Response

### 200

Task

- `completed_at` (string, optional)
- `created_at` (string, optional)
- `error` (apidata.TaskErrorResponse, optional)
- `params` (map from string to any, optional)
- `progress` (apidata.TaskProgress, optional)
- `started_at` (string, optional)
- `status` (string, optional)
- `task_id` (string, optional)
- `type` (string, optional)
- `updated_at` (string, optional)

## Errors

### 404 Not Found Error

Task not found

- `message` (string, optional)

### 500 Internal Server Error

Internal Server Error

- `message` (string, optional)

## Types

### apidata.TaskErrorResponse

- `code` (string, optional)
- `details` (map from string to any, optional)
- `message` (string, optional)

### apidata.TaskProgress

- `message` (string, optional)
- `stage` (string, optional)

## Examples

**Request**

```json
{}
```

**Response**

```json
{
  "completed_at": "2024-06-10T15:45:00Z",
  "created_at": "2024-06-10T14:00:00Z",
  "error": {
    "code": "TASK_TIMEOUT",
    "details": {
      "timeout_seconds": 3600,
      "attempt": 3
    },
    "message": "The task exceeded the maximum allowed execution time."
  },
  "params": {
    "user_id": "user_789",
    "priority": "high",
    "retry": false
  },
  "progress": {
    "message": "Processing data batch 4 of 10",
    "stage": "in_progress"
  },
  "started_at": "2024-06-10T14:05:00Z",
  "status": "failed",
  "task_id": "task_1234567890abcdef",
  "type": "data_processing",
  "updated_at": "2024-06-10T15:40:00Z"
}
```