---
search:
  tags:
    - projects
    - GET
seo:
  description: >-
    What are project documents? Project documents are structured… Reference for
    the GET /projects/{projectId}/documents endpoint in the Leadtime Public API
    API.
sidebar:
  badge: GET
  label: List documents for a project
title: List documents for a project
type: openapi-operation
---
**What are project documents?**
Project documents are structured documents (estimates, specifications, contracts) that are automatically generated from project data. They are based on saved project versions (snapshots) and can include dynamic content, variables, and conditional sections.

**Document types:**
- **Estimate**: Commercial proposals summarizing project services, quantities, discounts, and costs
- **Specification**: Detailed requirement documents describing what must be delivered
- **Custom Editor**: Free-form documents like contracts, NDAs, or custom agreements

**What is returned:**
A paginated grid/list of all documents for the specified project, including:
- Document title, type, and status
- Associated project version (snapshot)
- Contact person assigned to the document
- Creation date
- All fields can be filtered, sorted, and paginated

**Document statuses:**
- Draft: Initial version, not yet finalized
- Waiting for Approval: Sent to client for review
- Final: Ready for signing
- Accepted: Approved by client
- Rejected: Declined by client
- Parked: Temporarily set aside

**Important notes:**
- Documents are always linked to a specific project version for traceability
- Only documents from the current workspace are returned
- Requires permission to view projects in the workspace

Retrieves a paginated grid of documents with filtering and sorting capabilities. Quick search available on: title. Filterable fields: id, title, type, status, contactUserId, snapshotId, createdAt. Sortable fields: id, title, type, status, contactUserId, snapshotId, createdAt.

<Operation source="api-reference" id="projectdocumentscontroller-listdocuments" />