List projects

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.

On this page

• HTTP request
• URI Parameters
• Request Header
• Responses
• Security
• Python example
• Definitions
  • V1Project

HTTP request

GET https://api.parsewise.ai/api/v1/projects/

URI Parameters

Name	In	Required	Type	Description
folder_id	query	No	string	Limit results to one folder. Omit to return every live project. An empty value returns only unfiled projects.

Request Header

Name	Required	Type	Description
X-API-Key	Yes	string	API key with the pw_live_ prefix. See Authentication.

Responses

Status	Type	Description
200	array<V1Project>	—

Security

• ApiKeyAuth — apiKey — in X-API-Key header. API key with pw_live_ prefix.

Python example

import os
import requests

API_KEY = os.environ["PARSEWISE_API_KEY"]
BASE_URL = "https://api.parsewise.ai/api/v1"

params = {
    # "folder_id": "...",  # Limit results to one folder
}

resp = requests.get(
    f"{BASE_URL}/projects/",
    headers={"X-API-Key": API_KEY},
    params=params,
)
resp.raise_for_status()
print(resp.json() if resp.content else None)

Definitions

V1Project

A project: the top-level container that groups documents, agents, and extraction results.

Returned by GET /projects/ and GET /projects/{project_id}/; also accepted as the request body for PATCH /projects/{project_id}/, where only the fields you supply are updated. Server-managed fields such as id, created_at, last_visited_at, document_count, and agent_count are read-only.

Name	Required	Type	Description
id	Yes	string (uuid)	Stable identifier for the project (UUID).
name	Yes	string	Human-readable name shown in the UI and in lists.
description	No	string	Short description of what the project covers.
last_visited_at	Yes	string (date-time) (nullable)	Timestamp of the most recent visit to this project.
reference_date	No	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	No	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	Yes	integer	Number of documents currently in the project.
agent_count	Yes	integer	Number of non-draft agents configured on the project.
is_pinned	No	boolean	Whether the project is pinned to the top of the project list.
folder_id	No	string (uuid) (nullable)	Folder that contains this project. Null means the project sits at the root of the organisation folder tree.
project_modules	Yes	any	Per-project overrides for which application modules are enabled, keyed by module name with boolean values. A missing key falls back to the organisation’s default for that module.
target_output_schema	Yes	any (nullable)
output_mapping_status	Yes	string