Skip to main content

Retrieve current KYX check status / outcome.

GET 
/v1/parties/kyx/:arkVerificationId

This endpoint retrieves the current KYX check status.

The KYX status will stay in IN_PROGRESS status whilst a check is in progress. Once an outcome has been determined, the relevant KYX check status will change in the response to one of the following:

  • VERIFIED - The party has passed the KYX check and will advance to VERIFIED status
  • FAILED - The party has failed the KYX check. A new check can be initiated from this state.
  • ERRORED - The party has failed the KYX check. A new check can be initiated from this state.
  • UNDER_REVIEW - The KYX check is still in progress but requires manual intervention to complete.
  • DECLINED - The party has failed the KYX check due to numerous possible reasons (PEP or watchlist hit, etc.). The party can transition to TERMINATED status based on this outcome.

The party can only advance to ACTIVE status if the outcome of the KYX check is VERIFIED. Any other outcome will result in the party status remaining at PROSPECT.

Request​

Responses​

Returns the current KYX check status / outcome details. If the returned status is VERIFIED, the party will transition to VERIFIED and is now eligible to be onboarded to the core system.

Last updated on