---
title: "Get current-month registry egress by image for one app customer."
method: GET
path: "/registry/egress/images"
tags: ["registry"]
---

# Get current-month registry egress by image for one app customer.

`GET /registry/egress/images`

## Request

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

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

## Query parameters

- `pageSize` integer
- `currentPage` integer
- `app_id` string, required
- `customer_id` string, required

## Response `200`

GetEgressImagesResponse contains a paginated image egress ranking.

- object
  - `images` RegistryEgressImageResponse[]
    - `bytes` integer
    - `image_name` string
    - `image_reference` string
    - `registry_host` string
  - `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/images/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)