---
title: "GET /projects/{projectId}/images/id"
method: GET
path: "/projects/{projectId}/images/id"
---

# GET /projects/{projectId}/images/id

`GET /projects/{projectId}/images/id`

This API will return a set of Images for the specified tags and optionally iteration. If no iteration is specified the
current workspace is used.

## Path parameters

- `projectId` string, uuid, required

## Query parameters

- `imageIds` string[]
- `iterationId` string, uuid

## Response `200`

OK

- Image[]
  - `id` string, uuid — Id of the image.
  - `created` string, date-time — Date the image was created.
  - `width` integer — Width of the image.
  - `height` integer — Height of the image.
  - `resizedImageUri` string — The URI to the (resized) image used for training.
  - `thumbnailUri` string — The URI to the thumbnail of the original image.
  - `originalImageUri` string — The URI to the original uploaded image.
  - `tags` ImageTag[], nullable — Tags associated with this image.
    - `tagId` string, uuid
    - `tagName` string
    - `created` string, date-time
  - `regions` ImageRegion[], nullable — Regions associated with this image.
    - `regionId` string, uuid
    - `tagName` string
    - `created` string, date-time
    - `tagId` string, uuid, required — Id of the tag associated with this region.
    - `left` number, float, required — Coordinate of the left boundary.
    - `top` number, float, required — Coordinate of the top boundary.
    - `width` number, float, required — Width.
    - `height` number, float, required — Height.

## Other responses

- `default` — Error response

## Changes

- **2026-07-13** `e873dad2a189` — 1 warning, 2 info
  - deleted the `header` request parameter `Training-Key`
  - api operation id `GetImagesByIds` removed and replaced with `Images_ListByIds`
  - api tag `ImageApi` removed
- **2026-07-13** `82dfb72c78fa` — 2 info
  - api operation id `Images_ListByIds` removed and replaced with `GetImagesByIds`
  - api tag `ImageApi` added
- **2026-07-13** `50242c512f6f` — 1 info
  - endpoint added
- **2018-02-03** `8feb7cde15fc` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/cognitiveservices-customvision-training/changes/projects/:projectId/images/id/get.md)

---

[API](https://skmtc.dev/azure/apis/cognitiveservices-customvision-training.md) · [All operations](https://skmtc.dev/azure/apis/cognitiveservices-customvision-training/llms.txt) · [OpenAPI document](https://skmtc.dev/azure/apis/cognitiveservices-customvision-training/revisions/e873dad2a189?raw)