customers

List customers for an app.

Changed on Nov 3, 2026

Return a paginated list of customers for a specific app, with optional filtering by name, test status, and expiration. Includes customer metadata and instance information.

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

get/app/{app_id}/customers

Request

Base URL
https://api.replicated.com/vendor/v3
URL
https://api.replicated.com/vendor/v3/app/{app_id}/customers
Auth
API key in header Authorization

Path parameters

app_idstring required

App identifier

Query parameters

pageSizeinteger

Page size

currentPageinteger

Current page

sortColumnstring

Sort column

sortDescboolean

Sort descending

customerNamestring

filter by customer name

includeTestboolean

expiresBeforestring date-time

Response

ListCustomersResponse contains the JSON customers list

totalCustomersinteger

Changes

Nov 3, 2026a36c6aead22f Revision changes
- warning
  deleted the query request parameter ExpiresBefore
- warning
  deleted the query request parameter IncludeTest
- info
  added the new optional query request parameter expiresBefore
- info
  added the new optional query request parameter includeTest
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property // to the response with the status

Operation history