---
title: "POST /projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances"
method: POST
path: "/projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances"
tags: ["instanceGroups"]
---

# POST /projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances

`POST /projects/{project}/zones/{zone}/instanceGroups/{instanceGroup}/listInstances`

Lists the instances in the specified instance group.
The orderBy query parameter is not supported.
The filter query parameter is supported, but only for
expressions that use `eq` (equal) or `ne` (not equal) operators.

## Path parameters

- `project` string, required
- `zone` string, required
- `instanceGroup` string, required

## Query parameters

- `filter` string
- `maxResults` integer
- `orderBy` string
- `pageToken` string
- `returnPartialSuccess` boolean

## Request body

- InstanceGroupsListInstancesRequest
  - `instanceState` 'ALL' | 'RUNNING' — A filter for the state of the instances in the instance group. Valid options are ALL or RUNNING. If you do not specify this parameter the list includes all instances regardless of their state.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/compute.md) · [All operations](https://skmtc.dev/google/apis/compute/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/compute/revisions/6120ed8969d4/schema)