---
title: "Get region proposals for an image. Returns empty array if no proposals are found."
method: POST
path: "/projects/{projectId}/images/{imageId}/regionproposals"
tags: ["ImageRegionProposalApi"]
---

# Get region proposals for an image. Returns empty array if no proposals are found.

`POST /projects/{projectId}/images/{imageId}/regionproposals`

This API will get region proposals for an image along with confidences for the region. It returns an empty array if no proposals are found.

## Path parameters

- `projectId` string, uuid, required
- `imageId` string, uuid, required

## Response `200`

OK

- ImageRegionProposal
  - `projectId` string, uuid
  - `imageId` string, uuid
  - `proposals` RegionProposal[]
    - `confidence` number, float
    - `boundingBox` BoundingBox — Bounding box that defines a region of an image.
      - `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

---

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