Submit a KYC

Submits the person for a KYC by passing the person id.
Submit a KYC
 last updated: 
November 30, 2023

After collecting the individual's info, the person must meet the country's requirements to open a bank account. This verification is called Know Your Customer (KYC). Submit the person for a KYC verification using this API.


  1. POST /v1/person/:id/kyc


  1. {
  2.     "id": "kyc-d40f6bdd-6e12-446e-a3a8-7bd3b2dbb182",
  3.     "personId": "per-3ebfa3d2-5d36-411d-984a-9e3a328011c5",
  4.     "status": "submitted",
  5.     "reviewCode": "",
  6.     "reviewMessage": "",
  7.     "results": {
  8.         "idv": "notStarted",
  9.         "address": "notStarted",
  10.         "dateOfBirth": "notStarted",
  11.         "fraud": "notStarted",
  12.         "bank": "approved"
  13.     },
  14.     "createdAt": "2021-12-14T21:25:19Z",
  15.     "modifiedAt": "2021-12-14T22:02:38Z"
  16. }

When a person's KYC status is In Review you can re-submit them for KYC by calling this API again.