---
title: "Get Identity"
method: GET
path: "/v1/identities/{identity_id}"
tags: ["identities"]
---

# Get Identity

`GET /v1/identities/{identity_id}`

## Request

- Base URL: `https://api.cybret.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cybret.ai/v1/identities/{identity_id}`
- Auth: HTTP bearer

## Path parameters

- `identity_id` string, required

## Response `200`

Successful Response

- IdentityView: Customer identity row. Secret values are never included.
  - `identity_id` string, required
  - `label` string, required
  - `method` 'password' | 'session' | 'agent_generated' | 'google' | 'microsoft', required
  - `login_url` string, required
  - `username` string, required
  - `has_secret` boolean, required
  - `bindable` boolean
  - `target_id` string, required
  - `created_at` string, date-time, required
  - `role` 'owner' | 'peer'
  - `tenant_slot` 'A' | 'B'
  - `pool_source` 'managed' | 'customer' | 'hand': Where the bindable jar came from. ``customer`` is the product invite/signup path (PE). ``managed`` is a scan-scoped harness pool. ``hand`` is an operator-supplied jar.
  - `peer_of` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cybret/apis/api-scanner-control-plane.md) · [All operations](https://skmtc.dev/cybret/apis/api-scanner-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/cybret/apis/api-scanner-control-plane/revisions/4c9b522246af?raw)