---
title: "List customer instances."
method: GET
path: "/app/{app_id}/customer/{customer_id}/instances"
tags: ["instances"]
---

# List customer instances.

`GET /app/{app_id}/customer/{customer_id}/instances`

Return a list of all instances associated with a specific customer and app, including instance metadata and status.
Useful for tracking deployments and usage per customer.

Required RBAC Policy: kots/app/[:appid]/license/[:licenseid]/read

## Path parameters

- `customer_id` string, required
- `app_id` string, required

## Response `200`

ListCustomerInstancesResponse contains the JSON instances list

- object
  - `instances` CustomerInstance[]
    - `active` boolean
    - `appStatus` string
    - `client` string
    - `cloud` string
    - `clusterId` string
    - `createdAt` string, date-time
    - `embeddedClusterVersion` string
    - `instanceId` string
    - `isAirgap` boolean
    - `isArchived` boolean
    - `isDummyInstance` boolean
    - `isEmbeddedCluster` boolean
    - `isKurl` boolean
    - `k8sVersion` string
    - `kotsVersion` string
    - `kurlNodeCountReady` integer
    - `kurlNodeCountTotal` integer
    - `lastActive` string, date-time
    - `licenseId` string
    - `replicatedSdkVersion` string
    - `serviceAccountId` string
    - `tags` InstanceTag[]
      - `instanceId` string
      - `key` string
      - `origin` string
      - `value` string
    - `versionHistory` CustomerInstanceVersionHistory[]
      - `clusterId` string
      - `downstreamChannelId` string
      - `downstreamReleaseSequence` integer
      - `instanceId` string
      - `intervalLast` string, date-time
      - `intervalStart` string, date-time
      - `nativeHelmCount` integer
      - `replHelmCount` integer
      - `versionLabel` string

## Other responses

- `400` — Returned on bad input
- `401` — Return if the caller is not authorized
- `403` — Returned if the caller does not have the needed permission
- `404` — Returned on resource not found

---

[API](https://skmtc.dev/replicated/apis/vendor-api-v3-2.md) · [All operations](https://skmtc.dev/replicated/apis/vendor-api-v3-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/replicated/vendor-api-v3-2/revisions/6fcf9e54aba4/schema)