A single eKYC record with provider routing, stored session metadata, and an audit trail.
This is the minimum data shape needed for the MVP.
Provider payload or mock payload stored as JSON.
{
"status": "success",
"verification": {
"id": "a91cd6b9-9db4-425c-8964-0dba488746ef",
"code": 9001,
"person": {
"gender": "M",
"idNumber": null,
"lastName": "OZGUL",
"addresses": [
{
"fullAddress": "737 SW 109TH AVE APT 3020 MIAMI, FL 33174-1339"
}
],
"firstName": "SERHAN MEHMET AKIF",
"citizenship": null,
"dateOfBirth": "2005-05-29",
"nationality": null,
"yearOfBirth": null,
"placeOfBirth": null,
"pepSanctionMatch": "no match"
},
"reason": null,
"status": "approved",
"comments": [],
"document": {
"type": "DRIVERS_LICENSE",
"state": "FL",
"number": "O639-957-18-300-0",
"country": "US",
"validFrom": "2026-04-23",
"validUntil": "2027-04-23"
},
"attemptId": "b1391425-3ee9-469a-b8e6-6c5292d747c5",
"endUserId": "85af142c-bd60-45e8-a78e-20053c9fb3e0",
"riskScore": {
"score": 0.0015338123452447322
},
"reasonCode": null,
"riskLabels": [
{
"label": "session_vendor_provided_name_not_matching_with_name_on_the_document",
"category": "client_data_mismatch",
"sessionIds": []
},
{
"label": "document_and_device_country_mismatch",
"category": "device",
"sessionIds": []
},
{
"label": "document_and_network_country_mismatch",
"category": "network",
"sessionIds": []
},
{
"label": "session_face_crosslinked_with_multiple_sessions",
"category": "crosslinks",
"sessionIds": [
"e2163b13-5fa1-4aac-b720-dbd9191cc13b"
]
}
],
"vendorData": null,
"decisionTime": "2026-07-16T18:09:58.225273Z",
"acceptanceTime": "2026-07-16T18:08:32.087762Z",
"submissionTime": "2026-07-16T18:09:51.955029Z",
"additionalVerifiedData": {}
},
"technicalData": {
"ip": "47.64.51.179"
}
}
Every important status change should leave an audit trail.
{
"status": "success",
"verification": {
"id": "a91cd6b9-9db4-425c-8964-0dba488746ef",
"code": 9001,
"person": {
"gender": "M",
"idNumber": null,
"lastName": "OZGUL",
"addresses": [
{
"fullAddress": "737 SW 109TH AVE APT 3020 MIAMI, FL 33174-1339"
}
],
"firstName": "SERHAN MEHMET AKIF",
"citizenship": null,
"dateOfBirth": "2005-05-29",
"nationality": null,
"yearOfBirth": null,
"placeOfBirth": null,
"pepSanctionMatch": "no match"
},
"reason": null,
"status": "approved",
"comments": [],
"document": {
"type": "DRIVERS_LICENSE",
"state": "FL",
"number": "O639-957-18-300-0",
"country": "US",
"validFrom": "2026-04-23",
"validUntil": "2027-04-23"
},
"attemptId": "b1391425-3ee9-469a-b8e6-6c5292d747c5",
"endUserId": "85af142c-bd60-45e8-a78e-20053c9fb3e0",
"riskScore": {
"score": 0.0015338123452447322
},
"reasonCode": null,
"riskLabels": [
{
"label": "session_vendor_provided_name_not_matching_with_name_on_the_document",
"category": "client_data_mismatch",
"sessionIds": []
},
{
"label": "document_and_device_country_mismatch",
"category": "device",
"sessionIds": []
},
{
"label": "document_and_network_country_mismatch",
"category": "network",
"sessionIds": []
},
{
"label": "session_face_crosslinked_with_multiple_sessions",
"category": "crosslinks",
"sessionIds": [
"e2163b13-5fa1-4aac-b720-dbd9191cc13b"
]
}
],
"vendorData": null,
"decisionTime": "2026-07-16T18:09:58.225273Z",
"acceptanceTime": "2026-07-16T18:08:32.087762Z",
"submissionTime": "2026-07-16T18:09:51.955029Z",
"additionalVerifiedData": {}
},
"technicalData": {
"ip": "47.64.51.179"
}
}
{
"id": "a91cd6b9-9db4-425c-8964-0dba488746ef",
"code": 7002,
"action": "submitted",
"feature": "selfid",
"attemptId": "b1391425-3ee9-469a-b8e6-6c5292d747c5",
"endUserId": "85af142c-bd60-45e8-a78e-20053c9fb3e0",
"vendorData": ""
}
{
"id": "a91cd6b9-9db4-425c-8964-0dba488746ef",
"code": 7001,
"action": "started",
"feature": "selfid",
"attemptId": "b1391425-3ee9-469a-b8e6-6c5292d747c5",
"endUserId": "85af142c-bd60-45e8-a78e-20053c9fb3e0",
"vendorData": ""
}
{
"provider": "veriff",
"verificationUrl": "https://saas.veriff.com/v/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3ODQyMjUzMTIsInNlc3Npb25faWQiOiJhOTFjZDZiOS05ZGI0LTQyNWMtODk2NC0wZGJhNDg4NzQ2ZWYiLCJpaWQiOiJhNjQ2ZWMzNC04ZDJkLTRiODgtOGExZi1iMDQ4MDI2NDg2NmIiLCJ2aWQiOiJjNWJmMWMzOS04ODQ0LTQ0MGMtYjNjNi00ZGFmZTIwNzZlMTgiLCJjaWQiOiJzYWFzLTQiLCJleHAiOjE3ODQ4MzAxMTJ9.IMTfjCzgt106Pa_xlyzrknjszJOApFnKXpurMr619ys",
"providerSessionId": "a91cd6b9-9db4-425c-8964-0dba488746ef"
}
{
"provider": "veriff",
"countryCode": "DE",
"dateOfBirth": "2005-05-29T00:00:00.000Z",
"documentType": "driving_licence",
"applicantName": "Serhan Mehmet Akif Özgül",
"applicantSurname": "Özgül",
"applicantGivenName": "Serhan",
"applicantMiddleName": "Mehmet Akif"
}