---
title: "Get person IDs from a list of names or aliases"
method: GET
path: "/api/v0/celebrity-detection/persons/by-names-and-aliases"
tags: ["celebrity-detection"]
---

# Get person IDs from a list of names or aliases

`GET /api/v0/celebrity-detection/persons/by-names-and-aliases`

## Query parameters

- `person_names_or_aliases` string[], required

## Response `200`

Successful Response

- CelebrityDetectionGetPersonsByNamesAliasesResponse
  - `matches` CelebrityDetectionPersonNameMatch[], required — List of name to person_id mappings
    - `name` string, required — The name or alias that was searched
    - `person_id` string, uuid, nullable, required — The matched person ID, or None if not found

## 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-by-names-and-aliases-api-v-0-celebrity-detection-persons-by-names-and-aliases-get` removed and replaced with `celebrityDetection_get_persons_by_names_and_aliases_api_v0_celebrity_detection_persons_by_names_and_aliases_get`

[Change history](https://skmtc.dev/coactive/apis/api-reference/changes/api/v0/celebrity-detection/persons/by-names-and-aliases/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)