---
title: "Gets a list of container services in the specified subscription."
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/containerServices"
tags: ["ContainerServices"]
---

# Gets a list of container services in the specified subscription.

`GET /subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/containerServices`

Gets a list of container services in the specified subscription. The operation returns properties of each container service including state, orchestrator, number of masters and agents, and FQDNs of masters and agents.

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

OK

- ContainerServiceListResult — The response from the List Container Services operation.
  - `value` ContainerService[] — the list of container services.
    - `id` string — Resource Id
    - `name` string — Resource name
    - `type` string — Resource type
    - `location` string, required — Resource location
    - `tags` object — Resource tags
  - `nextLink` string — The URL to get the next set of container service results.

## Changes

- **2026-07-13** (2015-11-01-preview) `9c01991f05c4` — 1 info
  - endpoint added
- **2026-07-13** (2015-11-01-preview) `fd2cf16249c3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/compute-microsoft-containerservice-containerservice/changes/subscriptions/:subscriptionId/providers/Microsoft.ContainerService/containerServices/get.md)

---

[API](https://skmtc.dev/azure/apis/compute-microsoft-containerservice-containerservice.md) · [All operations](https://skmtc.dev/azure/apis/compute-microsoft-containerservice-containerservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/compute-microsoft-containerservice-containerservice/revisions/0e562f3ba3f9/schema)