---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/catalogGroups"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/catalogGroups"
tags: ["SubscriptionCatalogGroupsOps"]
---

# GET /subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/catalogGroups

`GET /subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/catalogGroups`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.BillingBenefits/catalogGroups`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

List catalog groups at the target scope.

## Path parameters

- `subscriptionId` string, uuid, required

## Query parameters

- `api-version` string, required
- `$filter` string

## Response `200`

Azure operation completed successfully.

- CatalogGroupListResult: The response of a CatalogGroup list operation.
  - `value` CatalogGroup[], required: The CatalogGroup items on this page
    - `id` string, arm-id: Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
    - `name` string: The name of the resource
    - `type` string: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    - `systemData` SystemData: Metadata pertaining to creation and last modification of the resource.
      - `createdBy` string: The identity that created the resource.
      - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that created the resource.
      - `createdAt` string, date-time: The timestamp of resource creation (UTC).
      - `lastModifiedBy` string: The identity that last modified the resource.
      - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key': The type of identity that last modified the resource.
      - `lastModifiedAt` string, date-time: The timestamp of resource last modification (UTC)
    - `properties` CatalogGroupProperties: Properties of a catalog group.
      - `benefitResourceType` 'Maccs' | 'Credits' | 'ConditionalCredits' | 'Discounts' | 'FreeServices' | 'SavingsPlans' | 'Reservations', required: The top-level ARM resource type for a billing benefit (e.g., maccs, credits, savingsPlans, reservations).
      - `displayName` string: Display name for the catalog group.
      - `shortDescription` string: Short description of the catalog group.
      - `longDescription` string: Long description of the catalog group.
      - `learnMoreLink` string, uri: Link to learn more about this catalog group. Uses the forward-link format https://go.microsoft.com/fwlink/?linkid=<linkId>.
      - `keywords` string[]: Manifest-sourced array of search terms for this catalog group. Omitted when empty.
      - `icon` string: The benefit type's icon as JSON-escaped SVG markup. After parsing, the value is a complete `<svg>…</svg>` element.
      - `capabilities` CatalogGroupCapability[]: Capabilities of the catalog group as key-value pairs. Omitted when a benefit type has no defined capabilities.
        - `name` string, required: The capability name (e.g., SelfServiceExchange, Renewability).
        - `value` string, required: The capability value (e.g., Supported, Not Supported).
      - `disclaimers` string[]: Optional disclaimers (legal or eligibility caveats) for the catalog group. Included only when caveats apply.
  - `nextLink` string, uri: The link to the next page of items

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-07-13** (2022-11-01) `524c785862c5`: 1 info
  - endpoint added
- **2022-11-14** (2022-11-01) `2a40ceec2c00`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits/changes/subscriptions/:subscriptionId/providers/Microsoft.BillingBenefits/catalogGroups/get.md)

---

[API](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits.md) - [All operations](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/billingbenefits-microsoft-billingbenefits/revisions/524c785862c5?raw)
