---
title: "Get faces with a person"
method: GET
path: "/api/v0/celebrity-detection/faces-with-person"
tags: ["celebrity-detection"]
---

# Get faces with a person

`GET /api/v0/celebrity-detection/faces-with-person`

## Query parameters

- `person_id` string, uuid, nullable
- `person_name` string, nullable

## Headers

- `Authorization` string, required

## Response `200`

Successful Response

- CelebrityDetectionGetFacesWithPersonResponse
  - `faces` CelebrityDetectionFace[], required — List of faces associated with the person (id, image_id, dataset_id, bbox, confidence)
    - `id` string, uuid, required — Face ID
    - `image_id` string, uuid, required — Asset ID (image_id or keyframe_id)
    - `dataset_id` string, uuid, required — Dataset ID
    - `bbox` CelebrityDetectionBoundingBox, required
      - `x1` number, double, required
      - `y1` number, double, required
      - `x2` number, double, required
      - `y2` number, double, required
    - `confidence` number, double, required — Confidence score of the face identification

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-12** `3683abf6922b` — 1 info
  - api operation id `get-faces-with-person-api-v-0-celebrity-detection-faces-with-person-get` removed and replaced with `celebrityDetection_get_faces_with_person_api_v0_celebrity_detection_faces_with_person_get`

[Change history](https://skmtc.dev/coactive/apis/api-reference/changes/api/v0/celebrity-detection/faces-with-person/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/3683abf6922b?raw)