---
title: "Returns details for a single instance group in the project."
method: GET
path: "/projects/{project_id}/compute/instance-groups/{instance_group_id}"
tags: ["Instance Groups"]
---

# Returns details for a single instance group in the project.

`GET /projects/{project_id}/compute/instance-groups/{instance_group_id}`

## Path parameters

- `instance_group_id` string, required
- `project_id` string, required

## Response `200`

- InstanceGroup
  - `active_instances` string[], required — List of IDs of running instances in the instance group.
  - `created_at` string, required — Creation timestamp of the instance group, in RFC3339 format.
  - `desired_count` integer, required — Desired number of instances for the instance group.
  - `id` string, required — ID of the instance group.
  - `inactive_instances` string[], required — List of IDs of non-running instances in the instance group.
  - `instances` string[], required — [To be deprecated] List of IDs of running instances in the instance group.
  - `name` string, required — Name of the instance group.
  - `project_id` string, required — ID of the project that owns the instance group.
  - `running_instance_count` integer, required — Number of running instances currently in the instance group.
  - `state` string, required — Current state of the instance group.
  - `template_id` string, required — ID of the instance template currently associated with the instance group.
  - `updated_at` string, required — Last update timestamp of the instance group, in RFC3339 format.

## Other responses

- `400` — Error Bad Request
- `401` — Error Authentication Failed
- `404` — Error Not Found
- `500` — Error Internal Server

---

[API](https://skmtc.dev/crusoecloud/apis/crusoe-cloud-api-gateway.md) · [All operations](https://skmtc.dev/crusoecloud/apis/crusoe-cloud-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/crusoecloud/crusoe-cloud-api-gateway/revisions/a3fd2dedc72b/schema)