Get Customer Product Status
GET
/api/v1/products/{productId}/customerStatus/{customerId}
Create Onboarding Session until the customer reaches
Approved.customerStatus)| Status | Meaning |
|---|---|
Draft | Onboarding started but nothing submitted |
Pending | Created, KYC not yet submitted |
Submitted | Details submitted to the provider |
UnderReview | Verification in progress |
NeedInformation | More information or documents required |
Approved | Customer verified and active on this product |
Rejected | Application rejected |
Cancelled | Application cancelled |
Failed | Verification failed |
customerStatus can be null when the customer has not started onboarding for the product at all.data)| Field | Type | Description |
|---|---|---|
customerId | string (uuid) | The customer this status applies to |
productId | string (uuid) | The product this status applies to |
fullName | string, nullable | Customer's full name |
email | string, nullable | Customer's email |
customerStatus | string, nullable | KYC state for this product - see the table above |
employeeId)are not reflected here.
Request
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/v1/products/b1f3c7a2-6c4e-4d91-9f2a-123456789abc/customerStatus/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'X-Idempotency-Key;'Response Response Example
200 - Verification in progress
{
"data": {
"customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"productId": "b1f3c7a2-6c4e-4d91-9f2a-123456789abc",
"fullName": "Jane Doe",
"email": "jane.doe@example.com",
"customerStatus": "UnderReview"
},
"requestId": "9f2c4b6e8a1d4f0cb7e35a91d2c46f80",
"timestamp": "2026-08-22T10:30:00.123Z"
}Modified at 2026-08-22 04:49:45