---
title: "Get list of projects"
method: GET
path: "/workspaces/{workspace_id}/projects"
tags: ["Projects"]
---

# Get list of projects

`GET /workspaces/{workspace_id}/projects`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/workspaces/{workspace_id}/projects`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Returns list of projects in given workspace. Query parameters can be used to optimize the response.

## Path parameters

- `workspace_id` integer, required: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.

## Query parameters

- `limit` integer: Max number of projects to return
- `offset` integer: Offset from the beginning of the project list
- `fields` string: Fields to be returned in a comma-separated format may include id, name, owner_workspace_id, updated_at.
- `sort` string: Returned projects are Sort by this parameter. Can be (id, name, owner_workspace_id, updated_at)
- `subscribed` string: If true, list only subscribed projects otherwise list all projects

## Response `200`

List of projects

- ProjectList
  - `projects` ProjectSchema[], required
    - `id` integer, nullable: unique identifier representing project
    - `name` string, nullable: Name of project
    - `owner_workspace_id` integer, nullable: Parent Workspace id
    - `updated_at` string, date-time, nullable: Time when last update to project has happened
    - `created_at` string, date-time, nullable: Time when project was created
    - `status` string, nullable: Status of project
    - `properties` object, nullable: Properties of project
  - `offset` integer
  - `limit` integer
  - `next` string, required: URI for next page of data

## Other responses

- `304`: Not Modified
- `400`: Bad Request
- `401`: Authorization error
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/5dfd1c296ded?raw)