---
title: "Get current-month registry egress ranked by customer for an app."
method: GET
path: "/registry/egress/customers"
tags: ["registry"]
---

# Get current-month registry egress ranked by customer for an app.

`GET /registry/egress/customers`

## Request

- Base URL: `https://api.replicated.com/vendor/v3`
- URL: `https://api.replicated.com/vendor/v3/registry/egress/customers`
- Auth: API key in header `Authorization`

Required RBAC Policy: kots/externalregistry/list
Required RBAC Policy: kots/app/[:appid]/read
Required RBAC Policy: kots/app/[:appid]/license/[:customerid]/read for every attributed customer

## Query parameters

- `pageSize` integer
- `currentPage` integer
- `sortColumn` string
- `sortDesc` boolean
- `app_id` string, required

## Response `200`

GetEgressCustomersResponse contains a paginated customer egress ranking.

- object
  - `customers` RegistryEgressCustomerResponse[]
    - `bytes` integer
    - `customer_id` string
    - `customer_name` string
    - `is_archived` boolean
    - `share` number, double
  - `period_end` string
  - `period_start` string
  - `total_bytes` integer
  - `total_count` integer

## 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

## Changes

- **2026-11-03** `a36c6aead22f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/replicated/apis/vendor-api-v3-2/changes/registry/egress/customers/get.md)

---

[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.dev/replicated/apis/vendor-api-v3-2/revisions/a36c6aead22f?raw)