Identity Check

The response will share details around the KYC status of a user.

identity_check_updated

Identity Check Updated Event Examples

{
   "createdAt":"2025-02-20T16:45:27.279Z",
   "customerId":"0db49bfa-27a0-42ba-9c57-1bcda16816dc",
   "escalationReasons":null,
   "externalCustomerId":"Ni3ZghbVhu1s2dYvfiVsLGKV",
   "id":"f00cc312-f1e5-418c-862f-043852faaf95",
   "level":2,
   "rejectType":null,
   "rejections":0,
   "result":"clear",
   "resultDescription":null,
   "status":"completed",
   "updatedAt":"2025-02-20T16:49:11.968Z"
}

{
   "createdAt":"2024-01-26T16:38:50.611Z",
   "customerId":"8f59449f-22af-4057-9bb8-bcb707ea4525",
   "escalationReasons":[
      "kyc_review"
   ],
   "externalCustomerId":"rf8nW8kEGav01SH2uscoFVCY",
   "id":"e5e096aa-b0ed-42c5-ab43-58f9751dd9c1",
   "level":3,
   "rejectType":"retry",
   "rejections":6,
   "result":"rejected",
   "resultDescription":"",
   "status":"completed",
   "updatedAt":"2025-02-20T16:54:54.031Z"
}

Parameter	Description
`createdAt`string	Time at which the object was created. Returned as an ISO 8601 string.
`customerId`string	The identifier of the customer the transaction is associated with.
`escalationReasons`	Whether or not the user KYC was reviewed and the reason
`externalCustomerId`string \| null	An identifier associated with the customer, provided by you.
`id`string	Unique identifier for the currency.
`level`number	Know Your Customer (KYC) level of the user
`rejectType`string \| null
`rejections`number
`result`string	Whether the user successfully passed or failed their KYC with MoonPay `clear` `rejected`
`resultDescription`string \| null	The user's KYC failure reason
`status`string	The user's KYC status.
`updatedAt`string	Time at which the object was last updated. Returned as an ISO 8601 string.