---
title: "Get a specific Image Object"
method: GET
path: "/orgs/{orgId}/images/{imageId}"
tags: ["public", "Image"]
---

# Get a specific Image Object

`GET /orgs/{orgId}/images/{imageId}`

DEPRECATED: This endpoint exists for historical compatibility and should not be used. Please use the [Artefact API](https://api-docs.humanitec.com/#tag/Artefact) instead.

The response includes a list of Image Builds as well as some metadata about the Image such as its Image Source.

Note, `imageId` may not be the same as the container name. `imageId` is determined by the system making notifications about new builds.

## Path parameters

- `orgId` string, required
- `imageId` string, required

## Response `200`

The Image Object requested.

- ImageResponse — DEPRECATED: This type exists for historical compatibility and should not be used. Please use the [Artefact API](https://api-docs.humanitec.com/#tag/Artefact) instead. Container Images (known simply as Images) can be registered with Humanitec. Continuous Integration (CI) pipelines can then notify Humanitec when a new build of a Container Image becomes available. Humanitec tracks the Image along with metadata about how it was built.
  - `added_at` string, required — The time the first build of this Image was added to the organization
  - `builds` ImageBuildResponse[], required — A list of Image Builds ordered by addition date.
    - `added_at` string — The time when the build was added to Humanitec.
    - `branch` string, required — The branch name of the branch the build was built on
    - `commit` string, required — The commit ID that this build was built from.
    - `image` string, required — The fully qualified Image URL including registry, repository and tag.
    - `tags` string[], required — The tag that the build was built from.
  - `id` string, required — The ID used to group different builds of the same Image together.
  - `source` string, required — The Image Source that this Image is added via

## Other responses

- `404` — No Image with an ID of `imageId` found within the organization.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)
