---
title: "List all catalog groups"
method: GET
path: "/v1/catalog-groups"
tags: ["Catalog Groups"]
---

# List all catalog groups

`GET /v1/catalog-groups`

**Note**: This operation is in the Early Adopter phase. We are actively soliciting feedback from a small set of early adopters before releasing it as generally available. If you want to join this early adopter program, submit a request at [Zuora Global Support](http://support.zuora.com/).

Retrieves basic information about all catalog groups.

## Query parameters

- `pageSize` integer
- `page` integer

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- ListAllCatalogGroupsResponse
  - `catalogGroups` CatalogGroupResponse[] — The list of catalog groups that are retrieved..
    - `catalogGroupNumber` string — The automatically generated number of the catalog group with the CG- perfix. For example, CG-00000001.
    - `description` string — The description of the catalog group.
    - `id` string — The ID of the catalog group.
    - `name` string — The name of the catalog group.
    - `productRatePlans` GETCatalogGroupProductRatePlanResponse[] — The list of product rate plans in the catalog group.
      - `description` string, nullable — The description of the product rate plan.
      - `effectiveEndDate` string — The effective end Date of the product rate plan.
      - `effectiveStartDate` string — The effective start date of the product rate plan.
      - `grade` number — The grade of the product rate plan.
      - `id` string — The ID of the product rate plan.
      - `name` string — The name of the product rate plan.
      - `organizationLabels` object[] — The organization(s) that the object belongs to. Note: This field is available only when the Multi-Org feature is enabled.
        - `organizationId` string — The organization ID.
        - `organizationName` string — The organization name.
      - `status` 'Active' | 'Expired' | 'NotStarted' — The status of the product rate plan.
    - `type` 'Grading' | 'Display' — The type of the catalog group.
  - `nextPage` string, URL — URL to retrieve the next page of the response if it exists; otherwise absent.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)