---
title: "Get a customer profile by DID"
method: GET
path: "/entities/{entityDID}/flow/customers/{customerDID}"
tags: ["Flow"]
---

# Get a customer profile by DID

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

Retrieves a customer profile within a Flow workflow context. Customer PII can be
optionally included in the response based on the includePII query parameter and
user permissions. PII data is decrypted on-demand when requested.

## Path parameters

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

## Query parameters

- `includePII` string

## Response `200`

Customer profile retrieved successfully

- object
  - `customerDid` string — Customer DID identifier
  - `entityDid` string — Entity DID that owns this customer
  - `customerType` 'natural_person' | 'legal_person' — Type of customer
  - `profileData` object — IVMS101 customer profile data. If includePII=false (default), PII is encrypted. If includePII=true, PII is decrypted and returned in plaintext.
  - `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

## 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` — Customer not found
- `500` — Could not fetch customer

---

[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)