---
title: "List Identities"
method: GET
path: "/v1/identities"
tags: ["identities"]
---

# List Identities

`GET /v1/identities`

## 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`
- Auth: HTTP bearer

## Query parameters

- `target_id` string, nullable

## Response `200`

Successful Response

- IdentityListResponse
  - `items` IdentityView[], required
    - `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)