> ## Documentation Index
> Fetch the complete documentation index at: https://bunny.net/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Find Container Image

> Parses an image reference like "ghcr.io/owner/app:v1" or "owner/app" and checks whether the image tag exists in the selected registries of the user (only those of the reference's host when it has one). Returns every registry that has the image tag with its id, hostname, the image namespace, name, tag and digest.



## OpenAPI

````yaml https://api-mc.opsbunny.net/docs/public/swagger.json post /registries/images/find
openapi: 3.0.4
info:
  title: Public API
  description: 'Public API endpoints for user consumption. Release version: v1.10.13.1'
  version: '1.0'
servers:
  - url: https://api.bunny.net/mc
security:
  - AccessKey: []
paths:
  /registries/images/find:
    post:
      tags:
        - ContainerRegistries
      summary: Find Container Image
      description: >-
        Parses an image reference like "ghcr.io/owner/app:v1" or "owner/app" and
        checks whether the image tag exists in the selected registries of the
        user (only those of the reference's host when it has one). Returns every
        registry that has the image tag with its id, hostname, the image
        namespace, name, tag and digest.
      operationId: FindContainerImage
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FindContainerImageRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/FindContainerImageRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/FindContainerImageRequest'
      responses:
        '200':
          description: >-
            The image tag exists in at least one of the user's registries; every
            such registry is listed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindContainerImageResponse'
        '400':
          description: The request is invalid, e.g. no registry is selected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '401':
          description: User is unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '404':
          description: >-
            None of the selected registries is the user's or is for the image
            host, or the image tag was not found in any of them.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '422':
          description: The image reference is invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '502':
          description: >-
            The image was found nowhere and a registry failed to answer (also
            503 and other registry errors).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetails'
components:
  schemas:
    FindContainerImageRequest:
      required:
        - image
        - registryIds
      type: object
      properties:
        image:
          maxLength: 512
          minLength: 1
          type: string
          description: >-
            Image reference in the docker format:
            [registry/]namespace/name[:tag], e.g. "ghcr.io/owner/app:v1" or
            "owner/app".

            Without a registry host all of the user's registries are searched.

            The tag defaults to "latest".
        registryIds:
          minItems: 1
          type: array
          items:
            type: string
          description: >-
            The registries to search: ids of the user's registries, or
            "dockerhub" / "github". At least one is required;

            ids that are not the user's registries are skipped. With a registry
            host in the image reference, only the

            selected registries of that host are searched.
      additionalProperties: false
    FindContainerImageResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/FoundContainerImage'
        meta:
          $ref: '#/components/schemas/ListMeta'
        cursor:
          type: string
          nullable: true
      additionalProperties: false
      description: >-
        Every registry of the user that has the image tag, in the order they
        were queried

        (the user's own private registries first, then public and platform
        ones).
    ErrorDetails:
      type: object
      properties:
        title:
          type: string
          description: A short, human-readable summary of the problem type.
          readOnly: true
        status:
          type: integer
          description: The HTTP status code.
          format: int32
          readOnly: true
        detail:
          type: string
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          nullable: true
          readOnly: true
        instance:
          type: string
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          nullable: true
          readOnly: true
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
          description: Additional validation errors for field-specific issues.
          nullable: true
          readOnly: true
        id:
          type: string
          description: >-
            The application ID, returned as an RFC 7807 extension field when
            relevant (e.g. partial save errors).

            Matches the "id" field from successful create response for
            consistency.
          nullable: true
          readOnly: true
      additionalProperties: false
      description: RFC 7807 Problem Details response model.
    FoundContainerImage:
      required:
        - imageDigest
        - imageName
        - imageNamespace
        - imageTag
        - isPublic
        - registryHostname
        - registryId
      type: object
      properties:
        imageNamespace:
          type: string
        imageName:
          type: string
        registryId:
          type: string
        registryHostname:
          type: string
        isPublic:
          type: boolean
        imageTag:
          type: string
        imageDigest:
          type: string
      additionalProperties: false
    ListMeta:
      type: object
      properties:
        totalItems:
          type: integer
          format: int64
      additionalProperties: false
    ValidationError:
      required:
        - message
      type: object
      properties:
        field:
          type: string
          nullable: true
        message:
          type: string
      additionalProperties: false
  securitySchemes:
    AccessKey:
      type: apiKey
      description: Please enter a valid personal API key.
      name: AccessKey
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.