> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shiftsheet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Projects

> Retrieve a list of active and historical projects for your company.

This is commonly used to sync active projects into external tools like Jira, Trello, or invoicing systems.

### Query Parameters

<ParamField query="status" type="string">
  Filter projects by their status (e.g., `PROPOSED`, `ACTIVE`, `ON_HOLD`, `COMPLETED`, `CANCELLED`).
</ParamField>

### Response

<ResponseExample>
  ```json theme={null}
  {
    "data": [
      {
        "id": "proj_123...",
        "name": "Website Redesign",
        "code": "WEB-26",
        "description": "Complete overhaul of the marketing site",
        "status": "ACTIVE",
        "startDate": "2026-01-01T00:00:00.000Z",
        "endDate": "2026-06-30T00:00:00.000Z",
        "createdAt": "2026-01-01T00:00:00.000Z",
        "updatedAt": "2026-05-18T00:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>