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

# List projects

`GET /projects/`

## Request

- Base URL: `https://api.parsewise.ai/api/v1`
- URL: `https://api.parsewise.ai/api/v1/projects/`
- Auth: API key in header `X-API-Key`

Return all live projects in your organisation, ordered by name. Each project carries `document_count` and `agent_count`, so you can render summary views without follow-up requests. Pass `folder_id` to list only projects in that folder; pass an empty `folder_id` to list only unfiled (root) projects.

## Query parameters

- `folder_id` string

## Response `200`

- V1Project[]
  - `id` string, uuid, required: Stable identifier for the project (UUID).
  - `name` string, required: Human-readable name shown in the UI and in lists.
  - `description` string: Short description of what the project covers.
  - `last_visited_at` string, date-time, nullable, required: Timestamp of the most recent visit to this project.
  - `reference_date` string, date, nullable: Reference date used by agents that need a "today" anchor (e.g. relative date extractions). Defaults to the date the project was created.
  - `auto_archive_after_days` integer, nullable: Opt-in auto-archival for document-oriented projects: documents uploaded more than this many days ago are automatically moved into an archived project by a daily sweep. Null disables auto-archival.
  - `document_count` integer, required: Number of documents currently in the project.
  - `agent_count` integer, required: Number of non-draft agents configured on the project.
  - `is_pinned` boolean: Whether the project is pinned to the top of the project list.
  - `folder_id` string, uuid, nullable: Folder that contains this project. Null means the project sits at the root of the organisation folder tree.
  - `project_modules` unknown, required
  - `target_output_schema` unknown, required
  - `output_mapping_status` string, required

---

[API](https://skmtc.dev/parsewise/apis/parsewise-api.md) - [All operations](https://skmtc.dev/parsewise/apis/parsewise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/parsewise/apis/parsewise-api/revisions/5db46512debf?raw)