Get Applicant KYC Status

GET

/baseurl/api/v1/customers/{customerId}/products/{productId}/applicantstatus

Get the KYC/KYB application status for a customer and product.

Returns the card holder status from the latest CustomerWallet record, or UnderReview if no record exists or the status is not yet set.

Possible applicantStatus values:

Value	Description
`Approved`	KYC/KYB verified and approved
`Rejected`	KYC/KYB rejected — check `remarks` for reason
`UnderReview`	Application is under manual review or not yet submitted
`Pending`	Submitted, awaiting review

Request

Path Params

Header Params

Responses

🟢200

application/json

KYC application status retrieved successfully.

Body

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/baseurl/api/v1/customers/3fa85f64-5717-4562-b3fc-2c963f66afa6/products/7d444840-9dc0-11d1-b245-5ffdce74fad2/applicantstatus' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'

Response Example

{
    "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "productId": "7d444840-9dc0-11d1-b245-5ffdce74fad2",
    "applicantStatus": "Approved",
    "remarks": "KYC verification completed successfully"
}

Modified at 2026-03-31 11:53:55

Submit KYC/KYB Applicant

Issue Card