---
title: "List customers for an entity within Flow workflows"
method: GET
path: "/entities/{entityDID}/flow/customers"
tags: ["Flow"]
---

# List customers for an entity within Flow workflows

`GET /entities/{entityDID}/flow/customers`

Retrieves a paginated list of customers associated with an entity within Flow
workflow contexts. Customer PII in profileData is encrypted and not included
by default for security and privacy compliance.

## Path parameters

- `entityDID` string, did, required — Decentralized Identifier (DID)

## Query parameters

- `limit` string
- `offset` string

## Response `200`

List of customers retrieved successfully

- object
  - `data` object[]
    - `customerDid` string — Customer DID identifier
    - `entityDid` string — Entity DID that owns this customer
    - `customerType` 'natural_person' | 'legal_person' — Type of customer
    - `profileData` object — Encrypted IVMS101 customer profile data (PII encrypted)
    - `verificationStatus` 'pending' | 'verified' | 'rejected' | 'expired' — Customer verification status
    - `verificationLevel` 'basic' | 'enhanced' | 'premium' — Level of verification performed
    - `verifiedAt` string, date-time — When verification was completed
    - `verificationExpiresAt` string, date-time — When verification expires
    - `createdAt` string, date-time — Customer creation timestamp
    - `updatedAt` string, date-time — Customer last update timestamp
  - `pagination` object
    - `limit` integer — Maximum number of customers returned
    - `offset` integer — Number of customers skipped
    - `total` integer — Total number of available customers

## Other responses

- `400` — Bad Request - The server could not process the request due to a client error.
- `401` — Unauthorized - Authentication information is missing or invalid.
- `403` — Forbidden - The server understood the request but refuses to authorize it.
- `404` — Not Found - The requested resource could not be found.
- `500` — Could not fetch customers

---

[API](https://skmtc.net/notabene/apis/notabene-api.md) · [All operations](https://skmtc.net/notabene/apis/notabene-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notabene/notabene-api/versions/70056745a433/schema)