---
title: "GET /projects/{project}/aggregated/instances"
method: GET
path: "/projects/{project}/aggregated/instances"
tags: ["instances"]
---

# GET /projects/{project}/aggregated/instances

`GET /projects/{project}/aggregated/instances`

Retrieves an aggregated list of all of the instances in your project
across all regions and zones.

The performance of this method degrades when a filter is specified on a
project that has a very large number of instances.

To prevent failure, Google recommends that you set the
`returnPartialSuccess` parameter to `true`.

## Path parameters

- `project` string, required

## Query parameters

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

## Response `200`

Successful response

---

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