---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.DevTestLab/labs"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.DevTestLab/labs"
tags: ["Labs"]
---

# GET /subscriptions/{subscriptionId}/providers/Microsoft.DevTestLab/labs

`GET /subscriptions/{subscriptionId}/providers/Microsoft.DevTestLab/labs`

List labs in a subscription.

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `$expand` string
- `$filter` string
- `$top` integer
- `$orderby` string
- `api-version` string, required

## Response `200`

OK

- ResponseWithContinuationLab — The response of a list operation.
  - `value` Lab[] — Results of the list operation.
    - `id` string — The identifier of the resource.
    - `name` string — The name of the resource.
    - `type` string — The type of the resource.
    - `location` string — The location of the resource.
    - `tags` object — The tags of the resource.
  - `nextLink` string — Link for next set of results.

## Other responses

- `default` — BadRequest

## Changes

- **2026-07-13** (2015-05-21-preview) `228c0007a018` — 1 warning, 7 info
  - deleted the `query` request parameter `$orderBy`
  - api operation id `Lab_ListBySubscription` removed and replaced with `Labs_ListBySubscription`
  - the endpoint scheme security `azure_auth` was added to the API
  - the endpoint scheme security `oauth2` was removed from the API
  - …4 more

[Change history](https://skmtc.dev/azure/apis/devtestlabs-microsoft-devtestlab-devtestlabs/changes/subscriptions/:subscriptionId/providers/Microsoft.DevTestLab/labs/get.md)

---

[API](https://skmtc.dev/azure/apis/devtestlabs-microsoft-devtestlab-devtestlabs.md) · [All operations](https://skmtc.dev/azure/apis/devtestlabs-microsoft-devtestlab-devtestlabs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/devtestlabs-microsoft-devtestlab-devtestlabs/revisions/228c0007a018/schema)