---
title: "Retrieve a catalog group"
method: GET
path: "/v1/catalog-groups/{catalog-group-key}"
tags: ["Catalog Groups"]
---

# Retrieve a catalog group

`GET /v1/catalog-groups/{catalog-group-key}`

**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 a catalog group.

## Path parameters

- `catalog-group-key` string, required

## 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

- CatalogGroupResponse
  - `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.

## 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)