---
title: "Gets Guest Usages resources under a subscription"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.AzureActiveDirectory/guestUsages"
tags: ["GuestUsages"]
---

# Gets Guest Usages resources under a subscription

`GET /subscriptions/{subscriptionId}/providers/Microsoft.AzureActiveDirectory/guestUsages`

Gets Guest Usages resources under a subscription for the Microsoft.AzureActiveDirectory resource provider

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

List of Guest Usages resources under the subscription successfully retrieved.

- GuestUsagesResourceList — The collection of guest usages resources
  - `value` GuestUsagesResource[] — List of guest usages resources
    - `id` string — An identifier that represents the Guest Usages resource.
    - `name` string — The name of the Guest Usages resource.
    - `type` string — The type of the Guest Usages resource.
    - `location` string — Location of the Guest Usages resource.
    - `tags` object — Key-value pairs of additional resource provisioning properties.
    - `properties` GuestUsagesResourceProperties — Guest Usages Resource Properties
      - `tenantId` string — An identifier for the tenant for which the resource is being created
    - `systemData` SystemData — unresolved $ref
  - `nextLink` string, nullable — The URL to get the next set of Guest Usages resources.

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/cpim-microsoft-azureactivedirectory-externalidentities.md) · [All operations](https://skmtc.net/azure/apis/cpim-microsoft-azureactivedirectory-externalidentities/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cpim-microsoft-azureactivedirectory-externalidentities/revisions/0ea03104124e/schema)