---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/digitalTwinsInstances"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/digitalTwinsInstances"
tags: ["DigitalTwinsInstance"]
---

# GET /subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/digitalTwinsInstances

`GET /subscriptions/{subscriptionId}/providers/Microsoft.DigitalTwins/digitalTwinsInstances`

Get all the DigitalTwinsInstances in a subscription.

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

This is a synchronous operation. The body contains a JSON-serialized array of the metadata from all the DigitalTwinsInstances in the subscription.

- DigitalTwinsDescriptionListResult — A list of DigitalTwins description objects with a next link.
  - `nextLink` string, nullable — The link used to get the next page of DigitalTwins description objects.
  - `value` DigitalTwinsDescription[] — A list of DigitalTwins description objects.
    - `id` string — The resource identifier.
    - `name` string — The resource name.
    - `type` string — The resource type.
    - `location` string, required — The resource location.
    - `tags` object, nullable — The resource tags.
    - `identity` DigitalTwinsIdentity — The managed identity for the DigitalTwinsInstance.
      - `type` 'None' | 'SystemAssigned' | 'UserAssigned' | 'SystemAssigned,UserAssigned' — The type of Managed Identity used by the DigitalTwinsInstance.
      - `principalId` string, nullable — The object id of the Managed Identity Resource. This will be sent to the RP from ARM via the x-ms-identity-principal-id header in the PUT request if the resource has a systemAssigned(implicit) identity
      - `tenantId` string, nullable — The tenant id of the Managed Identity Resource. This will be sent to the RP from ARM via the x-ms-client-tenant-id header in the PUT request if the resource has a systemAssigned(implicit) identity
      - `userAssignedIdentities` object, nullable — The list of user identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. .
    - `systemData` SystemData — Metadata pertaining to creation and last modification of the resource.
      - `createdBy` string, nullable — The identity that created the resource.
      - `createdByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key', nullable — The type of identity that created the resource.
      - `createdAt` string, date-time, nullable — The timestamp of resource creation (UTC).
      - `lastModifiedBy` string, nullable — The identity that last modified the resource.
      - `lastModifiedByType` 'User' | 'Application' | 'ManagedIdentity' | 'Key', nullable — The type of identity that last modified the resource.
      - `lastModifiedAt` string, date-time, nullable — The timestamp of resource last modification (UTC)

## Other responses

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

---

[API](https://skmtc.net/azure/apis/digitaltwins-microsoft-digitaltwins-digitaltwins.md) · [All operations](https://skmtc.net/azure/apis/digitaltwins-microsoft-digitaltwins-digitaltwins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/digitaltwins-microsoft-digitaltwins-digitaltwins/revisions/0244c7a17143/schema)