---
title: "Export customer instances for an app as CSV or JSON."
method: GET
path: "/app/{app_id}/customer_instances"
tags: ["apps"]
---

# Export customer instances for an app as CSV or JSON.

`GET /app/{app_id}/customer_instances`

Generate and return a report of all customer instances for a specific app, in either CSV or JSON format.
Includes instance metadata and supports filtering by customer IDs and archived status.

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

## Path parameters

- `app_id` string, required

## Query parameters

- `sortColumn` string
- `sortDesc` boolean
- `format` string
- `customerIds` string[]
- `IncludeArchived` boolean

## Response `200`

ListAppCustomerInstancesResponse contains the list of customers

## Other responses

- `400` — Returned on bad input
- `404` — Returned on resource not found

---

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