---
title: "List Tasks"
method: GET
path: "/v2/tasks"
tags: ["external", "external-v2"]
---

# List Tasks

`GET /v2/tasks`

## Request

- Base URL: `https://api.mem.ai`
- URL: `https://api.mem.ai/v2/tasks`
- Auth: HTTP bearer

List tasks for the authenticated caller's assistant with cursor pagination.
Results are ordered by `order_by` and return `next_page` when additional rows are available.
Use the optional `status` and `project_id` filters to narrow the result set.

## Query parameters

- `limit` integer, nullable: Maximum number of tasks in this page. Default is 50; valid range is 1 to 100.
- `page` string, nullable: Opaque cursor from a previous list response. Omit for the first page. IMPORTANT: Reuse with the same `order_by`, `status`, and `project_id` values.
- `order_by` 'created_at' | 'updated_at' | 'created_at_asc' | 'updated_at_asc': Sort key for pagination boundaries. Use `updated_at` (default) for newest-updated-first recency feeds, `updated_at_asc` for oldest-updated-first staleness sweeps, `created_at` for newest-created-first views, or `created_at_asc` for oldest-created-first views.
- `status` 'pending' | 'in_progress' | 'completed' | 'canceled'
- `project_id` string, uuid, nullable: Optional filter to tasks belonging to a single project.

## Response `200`

OK

- TaskListResponseSchema
  - `next_page` string, nullable: Opaque cursor for the next page of task results. `null` when there are no more results.
  - `request_id` string, required: Identifier for this API request. Useful for tracing and support.
  - `results` TaskResponseItemSchema[], required: Page of task results matching the requested filters and sort.
    - `created_at` string, date-time, required: Creation timestamp for the task in ISO 8601 format.
    - `description` string, nullable, required: Optional longer description currently stored on the task.
    - `due_at` string, date-time, nullable, required: Task deadline, if set, in ISO 8601 format.
    - `id` string, uuid, required: UUID of the task.
    - `project_id` string, uuid, nullable, required: UUID of the parent project, if any.
    - `status` string, required: Current task status (e.g. `pending`, `in_progress`, `completed`, `canceled`).
    - `title` string, required: Current title of the task.
    - `updated_at` string, date-time, required: Last modification timestamp for the task in ISO 8601 format.
  - `total` integer, required: Total number of matching tasks before pagination is applied.

## Changes

- **2026-11-03** `503bb357d07c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mem/apis/mem-public-client-api/changes/v2/tasks/get.md)

---

[API](https://skmtc.dev/mem/apis/mem-public-client-api.md) - [All operations](https://skmtc.dev/mem/apis/mem-public-client-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mem/apis/mem-public-client-api/revisions/503bb357d07c?raw)