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

# List identities

`GET /api/cis/v1/identities`

## Query parameters

- `status` 'PENDING' | 'ACTIVE' | 'IN_REVIEW' | 'DENIED' | 'BLOCKED' | 'FROZEN'
- `type` 'INDIVIDUAL' | 'BUSINESS'
- `q` string
- `limit` integer
- `offset` integer

## Headers

- `x-tenant-id` string, required

## Response `200`

Paginated identity list

- object
  - `items` Identity[]
    - `id` string, uuid
    - `tenantId` string
    - `type` 'INDIVIDUAL' | 'BUSINESS'
    - `status` 'PENDING' | 'ACTIVE' | 'IN_REVIEW' | 'DENIED' | 'BLOCKED' | 'FROZEN'
    - `pii` object — Encrypted PII fields (email, name, DOB, etc.)
    - `metadata` object, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `total` integer
  - `limit` integer
  - `offset` integer

---

[API](https://skmtc.net/stalela/apis/stalela-cis-customer-identity-service-api.md) · [All operations](https://skmtc.net/stalela/apis/stalela-cis-customer-identity-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stalela/stalela-cis-customer-identity-service-api/revisions/3065faad0b6b/schema)