---
title: "Get untagged images whose suggested tags match given tags. Returns empty array if no images are found."
method: POST
path: "/projects/{projectId}/images/suggested"
tags: ["ImageApi"]
---

# Get untagged images whose suggested tags match given tags. Returns empty array if no images are found.

`POST /projects/{projectId}/images/suggested`

This API will fetch untagged images filtered by suggested tags Ids. It returns an empty array if no images are found.

## Path parameters

- `projectId` string, uuid, required

## Query parameters

- `iterationId` string, uuid, required

## Request body

- SuggestedTagAndRegionQueryToken — Contains properties we need to fetch suggested tags for. For the first call, Session and continuation set to null. Then on subsequent calls, uses the session/continuation from the previous SuggestedTagAndRegionQuery result to fetch additional results.
  - `continuation` string — Continuation Id for database pagination. Initially null but later used to paginate.
  - `maxCount` integer — Maximum number of results you want to be returned in the response.
  - `session` string — SessionId for database query. Initially set to null but later used to paginate.
  - `sortBy` 'UncertaintyAscending' | 'UncertaintyDescending' — OrderBy. Ordering mechanism for your results.
  - `tagIds` string[] — Existing TagIds in project to filter suggested tags on.
  - `threshold` number, double — Confidence threshold to filter suggested tags on.

## Response `200`

OK

- SuggestedTagAndRegionQuery — The array of result images and token containing session and continuation Ids for the next query.
  - `results` StoredSuggestedTagAndRegion[] — Result of a suggested tags and regions request of the untagged image.
    - `created` string, date-time — Date this prediction was created.
    - `domain` string, uuid — Domain used for the prediction.
    - `height` integer — Height of the resized image.
    - `id` string, uuid — Prediction Id.
    - `iteration` string, uuid — Iteration Id.
    - `originalImageUri` string — The URI to the original prediction image.
    - `predictionUncertainty` number, double — Uncertainty (entropy) of suggested tags or regions per image.
    - `predictions` Prediction[] — List of predictions.
      - `boundingBox` BoundingBox — Bounding box that defines a region of an image.
        - `height` number, float, required — Height.
        - `left` number, float, required — Coordinate of the left boundary.
        - `top` number, float, required — Coordinate of the top boundary.
        - `width` number, float, required — Width.
      - `probability` number, float — Probability of the tag.
      - `tagId` string, uuid — Id of the predicted tag.
      - `tagName` string, nullable — Name of the predicted tag.
    - `project` string, uuid — Project Id.
    - `resizedImageUri` string — The URI to the (resized) prediction image.
    - `thumbnailUri` string — The URI to the thumbnail of the original prediction image.
    - `width` integer — Width of the resized image.
  - `token` SuggestedTagAndRegionQueryToken — Contains properties we need to fetch suggested tags for. For the first call, Session and continuation set to null. Then on subsequent calls, uses the session/continuation from the previous SuggestedTagAndRegionQuery result to fetch additional results.
    - `continuation` string — Continuation Id for database pagination. Initially null but later used to paginate.
    - `maxCount` integer — Maximum number of results you want to be returned in the response.
    - `session` string — SessionId for database query. Initially set to null but later used to paginate.
    - `sortBy` 'UncertaintyAscending' | 'UncertaintyDescending' — OrderBy. Ordering mechanism for your results.
    - `tagIds` string[] — Existing TagIds in project to filter suggested tags on.
    - `threshold` number, double — Confidence threshold to filter suggested tags on.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/azure/apis/cognitiveservices-training.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-training/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-training/versions/5e046876eb12/schema)