---
title: "List Project Groups"
method: GET
path: "/project-groups"
tags: ["Project Group"]
---

# List Project Groups

`GET /project-groups`

Retrieves a list of all the project groups in an account.

## Query parameters

- `top` integer
- `skip` integer
- `location` string[]
- `locationStrategy` 'location' | 'lineage' | 'bloodline' | 'genealogy'
- `fields` string

## Headers

- `Authorization` string, required
- `X-LC-Tenant` string, required

## Response `200`

- ListProjectGroupsResponse — A response for the List Project Groups endpoint.
  - `itemCount` integer, required
  - `items` ProjectGroup[], required
    - `id` string, required — The project group identifier.
    - `shortId` string — The short identifier of the project group.
    - `name` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">The project group name.</div>
    - `description` string — The project group description.
    - `status` 'new' | 'inProgress' | 'completed' | 'deleting' — The status of the projects in the project group. - `new`: the group is new created, or all projects in the group have status New - `inProgress`: at least one project in the group is in progress - `completed`: all projects in the group have status Completed - `deleting`: the group is getting deleted and the projects are removing from it
    - `projects` ProjectGroupProject[] — The projects in the project group.
      - `id` string, required — The project identifier.
      - `status` 'attaching' | 'attached' | 'detaching' | 'updating' | 'failed' — The project's status.
    - `location` FolderV2 — Folder used for resource storage.
      - `id` string, required — The folder identifier.
      - `name` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div><div style="display: inline;">The name of the folder.</div>
      - `hasParent` boolean, nullable — Indicates if the folder has a parent folder.
      - `path` FolderPath[] — The hierarchical path. It consists of all the items of the path in reverse order, the parent of the current folder being the first in the list, and the root of the account being the last.
        - `id` string, required — The folder identifier.
        - `name` string, required — The name of the folder.
        - `location` string — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div>The location identifier.
        - `hasParent` boolean, nullable — <div style="display:inline; float:right; color:#008080; margin-top:-23px; font-size:11px">default</div>Indicates if the folder has a parent folder.
    - `createdAt` string, date-time — The date and time when the project group was created. <br> UTC Timezone <br> Allowed formats: <br> "YYYY-MM-DDThh:mmZ" <br> "YYYY-MM-DDThh:mm:ssZ" <br> "YYYY-MM-DDThh:mm:ss.sZ" <br> "YYYY-MM-DDThh:mm:ss.ssZ" <br> "YYYY-MM-DDThh:mm:ss.sssZ"
    - `lastModifiedAt` string, date-time — The date and time when the project group was modified. <br> UTC Timezone <br> Allowed formats: <br> "YYYY-MM-DDThh:mmZ" <br> "YYYY-MM-DDThh:mm:ssZ" <br> "YYYY-MM-DDThh:mm:ss.sZ" <br> "YYYY-MM-DDThh:mm:ss.ssZ" <br> "YYYY-MM-DDThh:mm:ss.sssZ"

## Other responses

- `400` — Error codes: * “invalid”: Invalid input in the query parameter mentioned in the “name” field on the error response.
- `401` — The user could not be identified.
- `416` — Error codes: * "requestedRangeNotSatisfiable": The requested entity or one of its dependencies attempted to retrieve data outside the allowed range. Skip+Top might be outside the supported range.

---

[API](https://skmtc.net/rws/apis/trados-cloud-platform-api.md) · [All operations](https://skmtc.net/rws/apis/trados-cloud-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rws/trados-cloud-platform-api/revisions/d42dac7c28a3/schema)