Fetch KYC Risk Assessment Details for a Customer

5 Fetch KYC Risk Assessment Details for a Customer

This chapter describes the getKycRiskAssessmentDtlsForCustomer API, which helps retrieve customer risk assessment details.

The getKycRiskAssessmentDtlsForCustomer API retrieves customer KYC risk assessment information based on the customer identifier received from the source system.

End Point Details

HTTPS Link: https://<hostname>:<port>/kyc-customer-service/v1/getKycRiskAssessmentDtlsForCustomer
Method: POST
Content-Type: Application/JSON.

Request JSON Sample

{
  "customerID": "KYCTST-CU-006"
}

Response JSON Sample

{
  "data": [
    {
      "runDate": "2026-02-09 12:56:06.0",
      "nextReviewDate": "2026-03-09",
      "kycRiskCtgry": "Low",
      "kycRiskCtgryCode": "L",
      "oKycRisk": 90,
      "ficMisDate": "2015-12-02"
    }
  ]
}

Request Parameter

Table 5-1 Request Parameters

Parameter	Value Type	Description
customerID	String	Indicates the unique customer ID.

Response Parameters

Table 5-2 Response Parameters

Parameter	Value Type	Description
runDate	Date	Indicates the date and time when the latest KYC batch assessment was executed.
nextReviewDate	Date	Indicates the next scheduled KYC review date for the customer.
kycRiskCtgry	Varchar(30)	Indicates the latest Risk Assessment Category Name for the input customer.
kycRiskCtgryCode	String	Indicates the latest Risk Category Code for the input customer.
oKycRisk	Number	Indicates the latest KYC score for the customer, whether it is the system-calculated risk score or the overridden risk score.
ficMisDate	Date	Indicates the customer onboarding or reference MIS date received from the source system.

Note:

The nextReviewDate, kycRiskCtgry, kycRiskCtgryCode, and oKycRisk parameters represent the latest KYC details for the customer, including either the system-calculated values or the overridden values, whichever was updated most recently.