---
title: "List Projects"
method: GET
path: "/v2/projects"
tags: ["external", "external-v2"]
---

# List Projects

`GET /v2/projects`

List projects 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` filter to narrow the result set.

## Query parameters

- `limit` integer, nullable — Maximum number of projects 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` and `status` 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` 'active' | 'resolved' | 'archived'

## Response `200`

OK

- ProjectListResponseSchema
  - `next_page` string, nullable — Opaque cursor for the next page of project results. `null` when there are no more results.
  - `request_id` string, required — Identifier for this API request. Useful for tracing and support.
  - `results` ProjectResponseItemSchema[], required — Page of project results matching the requested filters and sort.
    - `created_at` string, date-time, required — Creation timestamp for the project in ISO 8601 format.
    - `description` string, nullable, required — Optional longer description currently stored on the project.
    - `id` string, uuid, required — UUID of the project.
    - `last_activity_at` string, date-time, nullable, required — Most recent activity timestamp on the project, if any.
    - `status` string, required — Current project status (`active`, `resolved`, or `archived`).
    - `title` string, required — Current title of the project.
    - `updated_at` string, date-time, required — Last modification timestamp for the project in ISO 8601 format.
  - `total` integer, required — Total number of matching projects before pagination is applied.

---

[API](https://skmtc.net/mem/apis/mem-api.md) · [All operations](https://skmtc.net/mem/apis/mem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mem/mem-api/revisions/4023cb07f31f/schema)