---
title: "List projects"
method: GET
path: "/projects/{workspaceId}"
tags: ["portal"]
---

# List projects

`GET /projects/{workspaceId}`

## Request

- Base URL: `https://productlane.com/api/v1`
- URL: `https://productlane.com/api/v1/projects/{workspaceId}`
- Auth: none declared

List all projects from a workspace by ID. Important: The workspace needs to have their portal/roadmap published, or the request will fail with the error 'Workspace not found'. No authorization is required.

## Path parameters

- `workspaceId` string, required

## Query parameters

- `language` string

## Response `200`

Successful response

- object[]
  - `id` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `color` string, nullable, required
  - `createdAt` string, date-time, required
  - `icon` string, nullable, required
  - `linearProjectId` string, nullable, required
  - `linearTeamIds` string[], required
  - `progress` number, nullable, required
  - `sortOrder` number, required
  - `state` string, nullable, required
  - `upvotes` number, required
  - `importanceScore` number, required

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/productlane/apis/productlane-api.md) · [All operations](https://skmtc.dev/productlane/apis/productlane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/productlane/apis/productlane-api/revisions/9325a8425b36?raw)