---
title: "Get persons in an image"
method: GET
path: "/api/v0/celebrity-detection/persons-in-image/{image_id}"
tags: ["celebrity-detection"]
---

# Get persons in an image

`GET /api/v0/celebrity-detection/persons-in-image/{image_id}`

## Path parameters

- `image_id` string, uuid, required

## Response `200`

Successful Response

- CelebrityDetectionGetPersonsInImageResponse
  - `persons` CelebrityDetectionPerson[], required — List of persons identified in the image
    - `id` string, uuid, required — Person ID
    - `name` string, required — Person name
    - `aliases` string[], required — Person aliases
    - `bbox` CelebrityDetectionBoundingBox, required
      - `x1` number, double, required
      - `y1` number, double, required
      - `x2` number, double, required
      - `y2` number, double, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-17** `23dbda5f105c` — 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `HTTPBearer` was added to the API
- **2026-09-12** `3683abf6922b` — 1 info
  - api operation id `get-persons-in-image-api-v-0-celebrity-detection-persons-in-image-image-id-get` removed and replaced with `celebrityDetection_get_persons_in_image_api_v0_celebrity_detection_persons_in_image__image_id__get`

[Change history](https://skmtc.dev/coactive/apis/api-reference/changes/api/v0/celebrity-detection/persons-in-image/:image_id/get.md)

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/coactive/apis/api-reference/revisions/23dbda5f105c?raw)