identity-verification.status-updated
This event occurs when an Identity Verification (IDV) application’s status is updated.
id
string (UUID)
Event ID.
type
string
Event type. Value is identity-verification.status-updated.
createdAt
string (date-time)
Date and time the event occurred.
data
object
Data related to the event.
applicationId
string (UUID)
ID of the IDV application.
businessAccountId
string (UUID)
ID of the Business Account.
primaryAccountId
string (UUID)
ID of the Primary Account.
identityVerificationProfileId
string
IDV profile used to process the IDV application.
applicationCreatedAt
string (date-time), format: yyyy-MM-dd’T’HH:mm:ss.SSSz
Date and time the IDV application was created in the RocketKOR system.
applicationCompletedAt
string (date-time)
Date and time the IDV application was completed in the RocketKOR system.
applicationUpdatedAt
string (date-time), format: yyyy-MM-dd’T’HH:mm:ss.SSSz
Date and time the IDV application was last updated in the RocketKOR system.
applicationCreatedBy
object
Entity that created the IDV application.
id
string (UUID)
ID of the entity. Will be blank if createdBy.type is internal.
type
string enum, values: employee, internal, kor_employee, service-account
Type of entity. The following values are supported:
name
string
Name of the entity.
applicationUpdatedBy
object
Entity that last updated the IDV application.
id
string (UUID)
ID of the entity. Will be blank if updatedBy.type is internal.
type
string enum, values: employee, internal, kor_employee, service-account
Type of entity. The following values are supported:
name
string
Name of the entity.
latestStatus
string enum, values: NEW, PENDING, PROCESSING, PENDING_REVIEW, PENDING_DOCUMENTS, AWAITING_INFORMATION, COMPLETED, EXPIRED, ERROR
Status of the IDV application. The following values are supported:
Note that an IDV application cannot be COMPLETED until all entities linked to the application have a COMPLETED status.
outcome
string
Final outcome of the IDV application. Only returned for applications with a COMPLETED status.
entities
array
RocketKOR entities linked to the IDV application. Each entity will be verified as part of the IDV process.
The following entities are verified for each type of IDV application:
accountId
string (UUID)
ID of the entity’s RocketKOR account. This could be a Business Account, Customer Account, or Beneficial Owner.
externalId
string (UUID)
Your organization’s external reference number for the entity.
latestStatus
string enum, values: NEW, PENDING, PROCESSING, PENDING_REVIEW, PENDING_DOCUMENTS, AWAITING_INFORMATION, COMPLETED, EXPIRED, ERROR
Status of the IDV application. The following values are supported:
Note that an IDV application cannot be COMPLETED until all entities linked to the application have a COMPLETED status.
docUploadUrl
string
URL to upload required documents for the entity’s IDV application. This URL is returned for applications with a PENDING_DOCUMENTS status.
outcome
string
Final outcome of the entity’s IDV application.
outcomeDetails
object
Details for each outcome.
outcomeReasons
object
Outcome reasons.
name
string
Name of the outcome reason.
type
string
Type of outcome reason.
tags
array of strings
Outcome detail tags.
createdAt
string (date-time), format: yyyy-MM-dd’T’HH:mm:ss.SSSz
Date and time the IDV application status was created in the RocketKOR system.
updatedAt
string (date-time), format: yyyy-MM-dd’T’HH:mm:ss.SSSz
Date and time the IDV application status was updated in the RocketKOR system.
createdBy
object
Entity that created the entity linked to the IDV application.
id
string (UUID)
ID of the entity. Will be blank if createdBy.type is internal.
type
string enum, values: employee, internal, kor_employee, service-account
Type of entity. The following values are supported:
name
string
Name of the entity.
updatedBy
object
Entity that last updated the entity linked to the IDV application.
id
string (UUID)
ID of the entity. Will be blank if updatedBy.type is internal.
type
string enum, values: employee, internal, kor_employee, service-account
Type of entity. The following values are supported:
name
string
Name of the entity.
Sample Payload Object
{
"id": "2e165f08-5706-4063-a9dc-5fc22a4af513",
"type": "identity-verification.status-updated",
"createdAt": "2025-04-10T21:10:53.857Z",
"data": {
"applicationId": "40ab062a-bcf6-468a-9f07-aba66a5d230c",
"businessAccountId": "f7f350ce-ddc9-40d4-a4aa-ef445a426c16",
"primaryAccountId": "6a46c358-a599-4fb0-b993-8c5021dad31f",
"identityVerificationProfileId": "kyc-profile-1",
"applicationCreatedAt": "2025-04-01T02:48:03.734Z",
"applicationCompletedAt": "2025-04-09T02:48:03.734Z",
"applicationUpdatedAt": "2025-04-08T02:48:03.734Z",
"applicationCreatedBy": {
"id": "c35cd9ae-7259-4b62-9679-0531d9369d8d",
"type": "service-account",
"name": "null"
},
"applicationUpdatedBy": {
"id": "c35cd9ae-7259-4b62-9679-0531d9369d8d",
"type": "service-account",
"name": "null"
},
"latestStatus": "NEW",
"outcome": "Approved",
"entities": [
{
"accountId": "7690752d-704c-4d80-825a-dc9b33333fa5",
"externalId": "ABC-100",
"latestStatus": "NEW",
"docUploadUrl": "https://docv.alloy.co/ABCDE",
"outcome": "Approved",
"outcomeDetails": {
"outcomeReasons": [
{
"name": "Phone match",
"type": "Fraud check"
}
],
"tags": [
"string"
]
},
"createdAt": "2025-04-09T02:48:03.734Z",
"updatedAt": "2025-04-09T02:48:03.734Z",
"createdBy": {
"id": "c35cd9ae-7259-4b62-9679-0531d9369d8d",
"type": "service-account",
"name": "null"
},
"updatedBy": {
"id": "c35cd9ae-7259-4b62-9679-0531d9369d8d",
"type": "service-account",
"name": "null"
}
}
]
}
}
Step into the future of Finance with RocketKOR! Simplify payments, banking, lending, and data analytics using our versatile KOR Platform.
A Rocket Financial Inc. company
@ 2024 RocketKOR, Inc. All rights reserved.
