---
title: "Instance Healthiness"
method: GET
path: "/aws/ec2/group/{groupId}/instanceHealthiness"
tags: ["Elastigroup AWS"]
---

# Instance Healthiness

`GET /aws/ec2/group/{groupId}/instanceHealthiness`

Get a list of instances with health status. In case a shutdown script is configured for the group, it will also retrieve the Spot Agent health status.

## Query parameters

- `accountId` string

## Parameters

- `#/paths/~1aws~1ec2~1group~1%7BgroupId%7D/put/parameters/0` — unresolved $ref

## Response `200`

Instance Healthiness Response

- object
  - `request` object — Original request properties
    - `id` string — Unique ID associated with this request
    - `url` string — The URL that was used for the request
    - `method` string — The HTTP **METHOD** used for the request
    - `timestamp` string — When the request was received by Spot
  - `response` object — Response package that includes, status, type and any relevant data.
    - `status` object
      - `code` integer — HTTP status code assigned to this response
      - `message` string — HTTP status message for the respective status code
    - `kind` string — The data type of each item in the response
    - `items` object[] — Array of data objects
      - `instanceId` string — Instance ID
      - `spotRequestId` string — Spot Request ID
      - `groupId` string — Group ID
      - `availabilityZone` string — Availability Zone
      - `lifeCycle` string — Life Cycle
      - `healthStatus` 'HEALTHY' | 'UNHEALTHY' | 'INSUFFICIENT_DATA' | 'UNKNOWN' — Health Status
      - `agentHealth` object
        - `status` 'HEALTHY' | 'UNHEALTHY' | 'UNKNOWN' — Spot Agent health status
        - `lastChecked` string — The last time Spot received a health signal from the instance
    - `count` integer — Size of the data object array

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/spot/apis/spot-by-flexera-api.md) · [All operations](https://skmtc.net/spot/apis/spot-by-flexera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spot/spot-by-flexera-api/revisions/72813baf8d47/schema)