---
title: "List Container Images"
method: POST
path: "/registries/images"
tags: ["ContainerRegistries"]
---

# List Container Images

`POST /registries/images`

## Request

- Base URL: `https://api.bunny.net/mc`
- URL: `https://api.bunny.net/mc/registries/images`
- Auth: API key in header `AccessKey`
- TypeScript: <https://skmtc.dev/bunny/apis/magic-containers-api/docs/registries/images/post.ts> (a function with typed inputs; its response is checked against the schema)

Lists all container images available in a private registry.

## Request body

- ListContainerImagesRequest
  - `registryId` string, required: The registry identifier. Can be "dockerhub", "github", or a private registry ID.

## Response `200`

Container images were successfully retrieved.

- ContainerImage[]
  - `id` string
  - `namespace` string

## Other responses

- `401`: User is unauthorized.
- `422`: Unprocessable entity.
- `500`: Unexpected server error.

## Changes

- **2026-04-26** `62fb48c758fb`: 4 info
  - added the optional property `id` to the response with the `422` status
  - added the optional property `id` to the response with the `500` status
  - the response property `errors/items/message` became required for the status `422`
  - the response property `errors/items/message` became required for the status `500`

[Operation history](https://skmtc.dev/bunny/apis/magic-containers-api/changes/registries/images/post.md)

---

[API](https://skmtc.dev/bunny/apis/magic-containers-api.md) - [All operations](https://skmtc.dev/bunny/apis/magic-containers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/magic-containers-api/revisions/7bb58a0591b0?raw)