---
title: "Resolve Principals"
method: GET
path: "/v1/principals"
tags: ["v1", "protected", "principals"]
---

# Resolve Principals

`GET /v1/principals`

Resolve the given ids. Unresolvable ids are absent from the response.

## Query parameters

- `ids` string[] — Principal ids to resolve

## Response `200`

Successful Response

- PrincipalResponse[]
  - `display_name` string, nullable
  - `email` string, nullable
  - `id` string, required
  - `type` 'user' | 'agent' | 'platform', required — What kind of thing an id refers to.

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-17** `e641bee7f63d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/principals/get.md)

---

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