---
title: "Search Public Container Images"
method: POST
path: "/registries/public-images/search"
tags: ["ContainerRegistries"]
---

# Search Public Container Images

`POST /registries/public-images/search`

## Request

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

Searches for public container images in a registry by prefix.

## Request body

- SearchPublicContainerImagesRequest
  - `registryId` string, required: The registry identifier. Can be "dockerhub", "github", or a private registry ID.
  - `prefix` string, required
  - `size` integer
  - `page` integer

## Response `200`

Public 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/public-images/search/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)