---
title: "Get Portfolio Groups"
method: GET
path: "/portfolio/groups"
tags: ["Portfolio Monitoring"]
---

# Get Portfolio Groups

`GET /portfolio/groups`

Get all portfolio groups in the organization with pagination.
Groups are sorted by created_at in descending order.
Optionally filter by group name using the 'q' parameter.

## Query parameters

- `q` string, nullable — The query param to search by portfolio group name. If provided, only groups with names containing this term (case-insensitive) will be returned.
- `limit` integer — Maximum number of records to return in a single page. Must be between 1 and 1000.
- `offset` integer, nullable — Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor.
- `cursor` string, nullable — Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset.

## Response `200`

Response

- V1PortfolioGroupSummaryResponse[]
  - `id` string, uuid, required — The unique identifier of the portfolio group.
  - `name` string, required — The name of the portfolio group.
  - `items_count` integer, required — The number of items in this portfolio group.
  - `created_at` string, date-time, required — When the portfolio group was created.
  - `updated_at` string, date-time, nullable, required — When the portfolio group was last updated.
  - `console_url` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/versions/0cc89938bc26/schema)