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

# List identities

`GET /api/cis/v1/identities`

## Request

- Base URL: `https://stalela-platform.vercel.app`
- URL: `https://stalela-platform.vercel.app/api/cis/v1/identities`
- Auth: HTTP bearer and API key in header `x-tenant-id`

## 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.dev/stalela/apis/stalela-cis-customer-identity-service-api.md) - [All operations](https://skmtc.dev/stalela/apis/stalela-cis-customer-identity-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stalela/apis/stalela-cis-customer-identity-service-api/revisions/3065faad0b6b?raw)
