---
title: "List VCHs in the specified datacenter of the target system"
method: GET
path: "/target/{target}/datacenter/{datacenter}/vch"
---

# List VCHs in the specified datacenter of the target system

`GET /target/{target}/datacenter/{datacenter}/vch`

A `GET` request on `/vch` under a datacenter will return information about the VCHs in that datacenter.

## Path parameters

- `target` string, required
- `datacenter` string, required

## Query parameters

- `compute-resource` string
- `thumbprint` string

## Response `200`

A list of VCHs

- object
  - `vchs` VCHListItem[]
    - `id` string
    - `name` string
    - `parent` ManagedObject
      - `id` string
      - `name` string
    - `version` string
    - `power_state` string
    - `upgrade_status` string
    - `admin_portal` string
    - `docker_host` string

## Other responses

- `default` — An error occurred

---

[API](https://skmtc.net/vmware/apis/vic-machine-api.md) · [All operations](https://skmtc.net/vmware/apis/vic-machine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vmware/vic-machine-api/revisions/022f4170e516/schema)