---
title: "GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/freeServices"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/freeServices"
tags: ["FreeServicesOperations"]
---

# GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/freeServices

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BillingBenefits/freeServices`

## Request

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

This operation lists the free services that are available under the specified resource group.

## Path parameters

- `subscriptionId` string, uuid, required
- `resourceGroupName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

Azure operation completed successfully.

- FreeServicesList: This operation lists the free services that are available under the specified subscription.
  - `value` FreeServices[]: The list of free services
    - `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)
    - `tags` object: Resource tags.
    - `location` string, required: The geo-location where the resource lives
    - `properties` FreeServicesProperties: Properties of free services
      - `productCode` string: This is the catalog UPN for the product.
      - `displayName` string: Display name
      - `status` 'Unknown' | 'Pending' | 'Active' | 'Canceled' | 'Completed': Status of the free services
      - `startAt` string, date-time: Date and time when the free services become active
      - `endAt` string, date-time: Expiration date and time of the free services
      - `provisioningState` 'Succeeded' | 'Failed' | 'Canceled' | 'Pending': Provisioning state for billing benefit resources. Includes the standard terminal states (Succeeded, Failed, Canceled) plus benefit-specific transition states.
      - `billingAccountResourceId` string, arm-id: Fully-qualified identifier of the billing account where the benefit is applied.
      - `billingProfileResourceId` string, arm-id: Fully-qualified identifier of the billing profile where the benefit is applied.
      - `customerResourceId` string, arm-id: Customer resource id where the benefit is scoped to.
      - `invitationId` string: Invitation identifier
      - `systemId` string: This is the globally unique identifier of the free services which will not change for its lifetime. Generated by the benefit publisher.
      - `productDetails` ProductDetailsBase: Common product detail properties shared across all benefit resources
        - `skuTitle` string: SKU title of the product
        - `productFamily` string: The product family, for example "Azure" or "M365".
        - `productType` string: The type of the product.
    - `managedBy` string: The fully qualified resource ID of the resource that manages this resource. Indicates if this resource is managed by another Azure resource. If this is present, complete mode deployment will not delete the resource if it is removed from the template since it is managed by another resource.
    - `kind` string: Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type. E.g. ApiApps are a kind of Microsoft.Web/sites type. If supported, the resource provider must validate and persist this value.
    - `etag` string: The etag field is *not* required. If it is provided in the response body, it must also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields.
    - `identity` ManagedServiceIdentity2: Managed service identity (system assigned and/or user assigned identities)
      - `principalId` string, uuid: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
      - `tenantId` string, uuid: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
      - `type` 'None' | 'SystemAssigned' | 'UserAssigned' | 'SystemAssigned,UserAssigned', required: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
      - `userAssignedIdentities` object: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.
    - `sku` Sku: The resource model definition representing SKU
      - `name` string, required: The name of the SKU. E.g. P3. It is typically a letter+number code
      - `tier` 'Free' | 'Basic' | 'Standard' | 'Premium': This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.
      - `size` string: The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code.
      - `family` string: If the service has different generations of hardware, for the same SKU, then that can be captured here.
      - `capacity` integer: If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted.
    - `plan` Plan: Plan for the resource.
      - `name` string, required: A user defined name of the 3rd Party Artifact that is being procured.
      - `publisher` string, required: The publisher of the 3rd Party Artifact that is being bought. E.g. NewRelic
      - `product` string, required: The 3rd Party artifact that is being procured. E.g. NewRelic. Product maps to the OfferID specified for the artifact at the time of Data Market onboarding.
      - `promotionCode` string: A publisher provided promotion code as provisioned in Data Market for the said product/artifact.
      - `version` string: The version of the desired product/artifact.
  - `nextLink` string: The URL to get the next set of results

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-07-13** (2022-11-01) `524c785862c5`: 3 breaking
  - added the new path request parameter `resourceGroupName`
  - added the new path request parameter `subscriptionId`
  - added the new required `query` request parameter `api-version`
- **2026-07-13** (2022-11-01) `c565d1268d5e`: 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/resourceGroups/:resourceGroupName/providers/Microsoft.BillingBenefits/freeServices/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)
