This page provides detailed definitions of response fields for the GET/Submission API.
Response Field (ID Document)
| Field Name | Description | Data Type | Category |
|---|---|---|---|
data | KYC applicant data | Object | KYC Applicant Info |
data.age_group | age group of the applicant: minor, early-teen, teen, adult | String | KYC Applicant Info |
data.first_name | First name of the applicant | String | KYC Applicant Info |
data.last_name | Last name of the applicant | String | KYC Applicant Info |
data.full_name | Full name of the applicant | String | KYC Applicant Info |
data.full_name_en | English Full Name provided after KYC approval. The name is processed through transliteration and not translated (e.g., KIM SAN instead of Kim Mountain). Returns null if KYC is not approved or name has not been transliterated. First Name and Last Name are not translated. | String | KYC Applicant Info |
data.gender | Gender of the applicant (male or female) | Enum | KYC Applicant Info |
data.nationality | Country code in ISO alpha-3 format | String | KYC Applicant Info |
data.date_of_birth | Date of birth in YYYY-MM-DD format | Date | KYC Applicant Info |
data.ip_address | IPv4 format IP address | String | KYC Applicant Info |
data.idType | Type of ID used | Enum | KYC Applicant Info |
data.idcard_issuingCountry | ISO alpha-3 format code of the ID issuing country ISO Alpha-3 Country Codes | String | KYC Applicant Info |
data.idcard_issueDate | ID issuance date in YYYY-MM-DD format | String | KYC Applicant Info |
data.idcard_expireDate | ID expiration date in YYYY-MM-DD format | String | KYC Applicant Info |
data.identityNumber | Identification number | String | KYC Applicant Info |
data.documentNumber | Document number of the ID | String | KYC Applicant Info |
data.address_city | City | String | KYC Applicant Info |
data.address_country | Country | String | KYC Applicant Info |
data.address_state | State | String | KYC Applicant Info |
data.address_street | Street | String | KYC Applicant Info |
data.address_street2 | Street 2 (additional address information) | String | KYC Applicant Info |
data.address_zipcode | Zip code | String | KYC Applicant Info |
data.address_globalCode | Global address code (e.g., 8Q98HXPG+MP) | String | KYC Applicant Info |
data.address_compoundCode | Compound address code (e.g., HXPG+MP Seoul, South Korea) | String | KYC Applicant Info |
data.address_formatted | Converted detailed address | String | KYC Applicant Info |
data.address_input | User-inputted address | String | KYC Applicant Info |
data.address_detail | Detailed user-inputted address | String | KYC Applicant Info |
data.cf1 | Custom field 1 optionally added during submission | String | KYC Applicant Info |
data.cf2 | Custom field 2 optionally added during submission | String | KYC Applicant Info |
data.cf3 | Custom field 3 optionally added during submission | String | KYC Applicant Info |
data.typeOfPermit | Permit class or visa type printed on the ID | String | KYC Applicant Info |
data.typeOfPermitGovKor | The submitter’s residency status or type registered with the Ministry of Justice of Korea | String | KYC Applicant Info |
data.expiryDateOfStayKor | Expiry date of stay registered with the Korean Ministry of Justice (YYYY-MM-DD format) | String | KYC Applicant Info |
data.nationalityGovKor | Applicant’s nationality registered with the Korean Ministry of Justice (e.g., American) | String | KYC Applicant Info |
image | Image object containing ArgosServer links for the ID document and selfie. Images can only be downloaded with GET/Image. | Object | Submission Info |
image.idImage | ArgosServer link for the ID document image (download is not available) | String | Submission Info |
image.idBackImage | ArgosServer link for the back side of the ID document (download is not available) | String | Submission Info |
image.selfieImage | ArgosServer link for the selfie image (download is not available) | String | Submission Info |
image.addressImage | ArgosServer link for the address document image (download is not available) | String | Submission Info |
memo | Dashboard submission memo object | Object | Dashboard Info |
memo.text | Dashboard submission memo content | String | Dashboard Info |
memo.updated_at | Timestamp when the dashboard submission memo was updated | String | Dashboard Info |
duplicated_users | List of submission IDs that contain duplicated PII | Array | KYC Applicant Info |
duplicated_selfie_users | List of submission IDs that contain duplicated selfie images | Array | KYC Applicant Info |
OCR_raw.rotate.value | Rotation angle detected by OCR | String | KYC Applicant Info |
OCR_raw.{item}.value | OCR-detected value for each item | String | KYC Applicant Info |
OCR_raw.{item}.score | Recognition confidence score (0–100) | Int | KYC Applicant Info |
OCR_raw.{item}.accepted | Indicates whether the OCR value was accepted | Bool | KYC Applicant Info |
OCR_raw.{item}.coordinates | Vector coordinates for the OCR-detected value | Object | KYC Applicant Info |
ocr.birthDate | Date of birth recognized by OCR (YYYY-MM-DD format) | Date | KYC Applicant Info |
ocr.issueDate | ID issuance date recognized by OCR | Date | KYC Applicant Info |
ocr.expireDate | ID expiration date recognized by OCR | Date | KYC Applicant Info |
ocr.firstName | First name recognized by OCR | String | KYC Applicant Info |
ocr.lastName | Last name recognized by OCR | String | KYC Applicant Info |
ocr.fullName | Full name recognized by OCR | String | KYC Applicant Info |
ocr.gender | Gender recognized by OCR (male or female) | Enum | KYC Applicant Info |
ocr.number | Document number recognized by OCR | String | KYC Applicant Info |
ocr.licenseNumber | License number recognized by OCR | String | KYC Applicant Info |
ocr.identityNumber | Korean national identification number recognized by OCR | String | KYC Applicant Info |
ocr.curpNumber | CURP number from MEX.ID recognized by OCR | String | KYC Applicant Info |
ocr.nationality | ISO alpha-3 nationality code recognized by OCR | String | KYC Applicant Info |
ocr.serialNumber | Serial number recognized by OCR | String | KYC Applicant Info |
ocr.typeOfPermit | Permit type recognized by OCR (e.g., F-4) | String | KYC Applicant Info |
review.birthDate | Birthdate reviewed by applicant (YYYY-MM-DD format) | Date | KYC Applicant Info |
review.issueDate | Issue date reviewed by applicant | Date | KYC Applicant Info |
review.expireDate | Expiration date reviewed by applicant | Date | KYC Applicant Info |
review.fullName | Full Name reviewed by applicant | String | KYC Applicant Info |
review.gender | Gender of applicant ( male / female ) | Enum | KYC Applicant Info |
review.nationality | ISO alpha-3 format nationality code reviewed by applicant | String | KYC Applicant Info |
review.documentNumber | Document number reviewed by applicant | String | KYC Applicant Info |
review.licenseNumber | License number reviewed by applicant | String | KYC Applicant Info |
review.identityNumber | Korean Unique identity number reviewed by applicant | String | KYC Applicant Info |
review.curpNumber | Curp Number from Mex.id reviewed by applicant | String | KYC Applicant Info |
email | Email address associated with the submission | String | KYC Applicant Info |
reviewer | Reviewer Type system indicates AI system review, agent indicates human review | Enum | KYC Review Info |
Injection_action.attemptStatus | The status of the injection action result | String | KYC injection Info |
Injection_action.createTime | Date and time of injection (UTC+0) *order: newest first | String | KYC injection Info |
Injection_action.userInput.address | Address infomation from user input | Object | KYC injection Info |
Injection_action.option.distanceChecks | Service used for injection distance checks and the measured distance | Object | KYC injection Info |
Injection_action.option.ipRisk | IP risk assessment category and prohibition time details | Object | KYC injection Info |
Injection_action.option.ipVerification | Verified accessed IP information | Object | KYC injection Info |
submission_id | Unique identifier assigned to each submission | String | Submission Info |
recognition_score | ID document recognition score | Float | Submission Info |
argos_score | ARGOS system comprehensive evaluation score | Float | Submission Info |
duplicated_information | A unique ID is generated based on name, date of birth, gender, and nationality for duplicate checks. (*Always generated when all four criteria are provided.) | String | Submission Info |
custom_duplicated_information | Identifier generated by custom duplicate check rules | String | Submission Info |
applicant_id | Identifier for users with duplicate submissions | String | Submission Info |
created_at | Date and time of submission (UTC+0) | String | Submission Info |
kyc_result_at | Date and time when the KYC result was finalized | String | Submission Info |
updated_at | Date and time when the submission was last updated | String | Submission Info |
pending_at | Date and time when the KYC submission was marked pending | String | Submission Info |
userid | Optional parameter added when creating a submission | String | Submission Info |
project_options | Object containing project configuration options | Object | Project Settings Info |
project_options.option_aml | Whether AML screening is enabled (true: enabled, false: disabled) | Boolean | Project Settings Info |
project_options.option_addressData | Whether address data collection is enabled (true: enabled, false: disabled) | Boolean | Project Settings Info |
project_options.policy_approvePeriod | Auto-approval period in days (0 disables auto-approval) | Number | Project Settings Info |
project_options.option_idNumber | Whether ID number collection is enabled (true: enabled, false: disabled) | Boolean | Project Settings Info |
project_options.policy_blacklistCountries | List of blacklisted countries (ISO alpha-3 country code array) | Array | Project Settings Info |
project_options.policy_acceptedID | List of accepted ID types (e.g., government_id, passport, drivers_license, etc.) | Array | Project Settings Info |
project_options.option_mask_documentNumber | Whether document number masking is enabled (true: enabled, false: disabled) | Boolean | Project Settings Info |
project_options.option_validationGov | Whether Korean government verification is enabled (true: enabled, false: disabled) | Boolean | Project Settings Info |
project_options.webhook | Object containing webhook configuration | Object | Project Settings Info |
project_options.webhook.createTime | Webhook creation time (ISO 8601 format) | String | Project Settings Info |
project_options.webhook.members | Array of webhook member information | Array | Project Settings Info |
project_options.webhook.url | Webhook URL | String | Project Settings Info |
project_options.option_mask_idNumber | Whether ID number masking is enabled (true: enabled, false: disabled) | Boolean | Project Settings Info |
project_options.option_documentNumber | Whether document number collection is enabled (true: enabled, false: disabled) | Boolean | Project Settings Info |
project_options.webhookURL | Webhook URL (simple string) | String | Project Settings Info |
project_options.policy_ageLimit | Age limit policy (minimum age) | Number | Project Settings Info |
project_options.option_ai_only | Whether AI-only review is enabled (true: enabled, false: disabled) | Boolean | Project Settings Info |
additional_list | User-inputted data for additional forms configured in the dashboard | Array | Additional Form Info |
additional_list.answer | Name of each additional form field | String | Additional Form Info |
additional_list.inputValue | User-inputted value for each field | String | Additional Form Info |
additional_list.blockType | Data type for each additional form field | String | Additional Form Info |
kyc | Object containing KYC results KYC Status | Object | KYC Result Info |
kyc.result | Status of the KYC process | Enum | KYC Result Info |
kyc.comment | Reason for KYC rejection Reject Codes and Comments | String | KYC Result Info |
kyc.commentCode | Code representing the reason for KYC rejection Reject Codes and Comments | String | KYC Result Info |
kyc.attempts[i].attemptCnt | Number of retries after failed submissions | Number | KYC Attempt Info |
kyc.attempts[i].idBarcodeResult | Barcode verification result for IDs from USA, CAN, and MEX | String | KYC Attempt Info |
kyc.attempts[i].ocrResult | OCR recognition result (success, fail) | Enum | KYC Attempt Info |
kyc.attempts[i].verificationResult | Result of ID verification (success, fail) | Enum | KYC Attempt Info |
kyc.attempts[i].verification | Detailed data of ID verification results | Object | KYC Attempt Info |
kyc.attempts[i].verificationParams | Parameters required for the ID verification execution | Object | KYC Attempt Info |
kyc.attempts[i].errorCode | Error code generated during liveness, face detection, face comparison, or ID verification | String | KYC Attempt Info |
kyc.attempts[i].errorMsg | Error message generated during liveness, face detection, face comparison, or ID verification | String | KYC Attempt Info |
kyc.attempts[i].step1Time1st | Timestamp of the first call to step1 | String | KYC Attempt Info |
kyc.attempts[i].step1Time2nd | Timestamp of the second call to step1 | String | KYC Attempt Info |
kyc.attempts[i].step1Time3rd | Timestamp of the third call to step1 | String | KYC Attempt Info |
kyc.attempts[i].step2Time1st | Timestamp of the first call to step2 | String | KYC Attempt Info |
kyc.attempts[i].step2Time2nd | Timestamp of the second call to step2 | String | KYC Attempt Info |
kyc.attempts[i].step2Time3rd | Timestamp of the third call to step2 | String | KYC Attempt Info |
kyc.attempts[i].retryMsg | Failure reason messages generated during liveness, face detection, face comparison, or ID verification | String | KYC Attempt Info |
kyc.attempts[i].retryCode | Failure reason codes generated during liveness, face detection, face comparison, or ID verification | String | KYC Attempt Info |
kyc.attempts[i].faceSimilarityScore | Face comparison similarity score | Float | KYC Attempt Info |
kyc.attempts[i].selfieImage | URL of the submitted selfie image | String | KYC Attempt Info |
kyc.attempts[i].livenessScore | Liveness score for the attempt | Float | KYC Attempt Info |
kyc.attempts[i].liveness | Detailed liveness metrics including score, probability, and quality | Object | KYC Attempt Info |
kyc.attempts[i].liveness.score | Overall liveness score | Float | KYC Attempt Info |
kyc.attempts[i].liveness.probability | Probability value for liveness | Float | KYC Attempt Info |
kyc.attempts[i].liveness.quality | Quality score for liveness | Float | KYC Attempt Info |
verification | Object containing face-based age verification results | Object | Face Age Verification Info |
verification.faceAge | Complete results array of face-based age verification (cumulative record per attempt) | Array | Face Age Verification Info |
verification.faceAge[i].usedValues | Age values used in verification | Object | Face Age Verification Info |
verification.faceAge[i].usedValues.originalSelfieLow | Lowest age estimate of selfie image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.originalSelfieHigh | Highest age estimate of selfie image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.originalSelfieMedian | Median age estimate of selfie image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.originalIdLow | Lowest age estimate of ID image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.originalIdHigh | Highest age estimate of ID image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.originalIdMedian | Median age estimate of ID image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.selfieLow | Lowest age estimate of selfie image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.selfieHigh | Highest age estimate of selfie image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.selfieMedian | Median age estimate of selfie image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.idLow | Lowest age estimate of ID image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.idHigh | Highest age estimate of ID image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.idMedian | Median age estimate of ID image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.birthDateAge | Age calculated from user-input date of birth | Number | Face Age Verification Info |
verification.faceAge[i].conditionResults | Verification result array for each condition | Array | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].condition | Condition setting information | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].condition.comparisonOperator | Comparison operator (gte: greater than or equal, gt: greater than, lte: less than or equal, lt: less than) | String | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].condition.target | Target age type for comparison (low, high, median) | String | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].conditionIndex | Condition index (starting from 0) | Number | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].finalResult | Final verification result of the condition (true: success, false: failure) | Boolean | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults | Comparison results for each target image and reference age combination | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.idCardCustomMatch | Comparison result between ID image and custom age value | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.idCardBirthDateMatch | Comparison result between ID image and birth date age | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.faceImageCustomMatch | Comparison result between selfie image and custom age value | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.faceImageBirthDateMatch | Comparison result between selfie image and birth date age | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.*.result | Success/failure result of individual comparison (true: success, false: failure, null: when absent) | Boolean | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.*.processed | Whether the comparison was executed (true: success, false: failure) | Boolean | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.*.statement | Specific content of comparison operation (e.g., “36 gte 18”) | String | Face Age Verification Info |
verification.faceAge[i].logicalOperators | Logical operator array between conditions (and, or) | Array | Face Age Verification Info |
signals | Object containing auxiliary data generated during submission processing (face age, camera process, OCR confidence, etc.) | Object | Face Detection Info |
signals.confidence | OCR recognition confidence score object. Confidence (0.0~1.0) per category. Corresponds to per-field confidence in dashboard submission detail. ⭐ NEW | Object | OCR Confidence Info |
signals.confidence.finalData | Confidence scores (0.0~1.0) for final data used in Argos Score calculation | Object | OCR Confidence Info |
signals.confidence.ocrData | Confidence scores (0.0~1.0) for OCR-extracted data | Object | OCR Confidence Info |
signals.confidence.ocrExtractedData | Confidence scores (0.0~1.0) for data extracted directly from the source by the OCR engine. Not returned for Korean national ID and driver’s license. | Object | OCR Confidence Info |
signals.faceAge | Age range information array extracted from faces (cumulative record per attempt) | Array | Face Detection Info |
signals.faceAge[i].ageRange | Age range detected in the attempt | Object | Face Detection Info |
signals.faceAge[i].ageRange.low | Detected lowest age estimate | Number | Face Detection Info |
signals.faceAge[i].ageRange.high | Detected highest age estimate | Number | Face Detection Info |
signals.faceAge[i].ageRange.median | Detected median age estimate | Number | Face Detection Info |
signals.faceAge[i].source | Age estimation source image type (selfieImage, idImage) | String | Face Detection Info |
signals.startButtonClickTime | Timestamp when the user clicked the start button (ISO 8601 format) | String | Camera Process Info |
signals.cameraProcessInfo | Array of camera operation data | Array | Camera Process Info |
signals.cameraProcessInfo[i].type | Process type (e.g., idcard-front-capture, id-document-face-passive, etc.) | String | Camera Process Info |
signals.cameraProcessInfo[i].processStartTime | Timestamp when the process started (ISO 8601 format) | String | Camera Process Info |
signals.cameraProcessInfo[i].processEndTime | Timestamp when the process ended (ISO 8601 format) | String | Camera Process Info |
signals.cameraProcessInfo[i].error | Error that occurred during the process (null if no error) | String | Camera Process Info |
updateHistory | Last update record of submission information | Object | Dashboard Info |
updateHistory.updateAdmin | Email of the admin who last updated the submission information | String | Dashboard Info |
updateHistory.updateTime | Timestamp when the submission information was last updated | String | Dashboard Info |
warning | Array containing warning information (only applies to ID Document). For the full list of possible codes and field mappings, see Warning Codes and Fields. | Array | Warning Info |
warning[i].userDataType | Input data type (e.g. ID Card, ID_card_uploaded, User Input) | String | Warning Info |
warning[i].relatedEngine | Name of the engine or validation stage that produced the warning | String | Warning Info |
warning[i].occurrenceTime | Timestamp when the warning occurred (ISO 8601) | String | Warning Info |
kyc.retry | Array containing retry information that caused retry conditions during KYC processing | Array | KYC Retry Info |
kyc.retry[i].type | Step type that caused the retry (step1, step2) | String | KYC Retry Info |
kyc.retry[i].retryCnt | Retry attempt number for this specific retry condition | Number | KYC Retry Info |
kyc.retry[i].retryCode | Code identifying the specific retry condition that occurred | String | KYC Retry Info |
kyc.retry[i].retryMessage | Detailed message explaining the retry condition and recommended action | String | KYC Retry Info |
aml | Object containing AML screening result data | Object | AML Screening Info |
aml.raw_data | Object containing raw AML screening results | Object | AML Screening Info |
aml.risk_level_summary | Summary of the risk level (Not Screened, High, Medium, Low)Risk Level | Enum | AML Screening Info |
aml.currentstatus | Current AML screening status (Not Screened, Red Flag)AML Screening Status | Enum | AML Screening Info |
aml.matches | Detailed AML screening results (only available when aml.currentstatus is Red Flag)AML Screening Info | Array | AML Screening Info |
aml.matches[i].risk_level | Risk level of the Red Flag (HIGH, MEDIUM, LOW) Risk Level | Enum | AML Screening Info |
aml.matches[i].argos_number | Unique ID for retrieving the AML report | String | AML Screening Info |
aml.matches[i].resource_id | Unique resource ID for retrieving the AML report | String | AML Screening Info |
aml.matches[i].score | AML screening match score | Float | AML Screening Info |
aml.matches[i].risk_icons | Risk icons for the AML screening | Array | AML Screening Info |
nextpageKey | Key object provided when additional pages of results are available | Object | Pagination Info |
nextpageKey.id | ID of the last submission retrieved, required for fetching the next page | String | Pagination Info |
nextpageKey.created_at | Timestamp of the last submission retrieved, required for fetching the next page | String | Pagination Info |
bank_verification | Object containing bank account verification results (for Korean users) | Object | Bank Verification Info |
bank_verification.result | Bank verification result (success, fail) | Enum | Bank Verification Info |
bank_verification.type | Type of bank verification (occupancy (1 KRW verification), nameCheck) | Enum | Bank Verification Info |
bank_verification.bank_code | Bank code used for verification | String | Bank Verification Info |
bank_verification.account_number | Account number used for verification | String | Bank Verification Info |
bank_verification.retry_count | Number of failures during code transmission (pre-step2) | Number | Bank Verification Info |
id_LivenessScore | Object containing ID Card Liveness Score data | Object | Liveness Score Info |
id_LivenessScore.Screen_play | Liveness score for the Screen play pipeline | Float | Liveness Score Info |
id_LivenessScore.Paper_printed | Liveness score for the Paper printed pipeline | Float | Liveness Score Info |
id_LivenessScore.Replace_portraits | Liveness score for the Replace portraits pipeline | Float | Liveness Score Info |
Injection_action | Object containing injection process execution history | Object | Injection Process Info |
Injection_action.type | Type of the injection process | String | Injection Process Info |
Injection_action.time | Most recent execution time of the specified injection process type | String | Injection Process Info |
projection | The object contains submission projection data | Object | Projection Info |
projection.projectionId | The projection ID into applied submission * If the submission created a projection ID, only the ID is shown. | String | Projection Info |
projection.projectionName | Applied submission projection name * If the submission created a projection name, only the name is shown. | String | Projection Info |
tokenId | Token ID used for live-form submissions in private mode | String | Submission Info |
pre_verification | List of pre-verification objects | Object | pre_verification Info |
pre_verification.request_id | Request ID for the pre-verification check | String | pre_verification Info |
pre_verification.created_at | Timestamp of the pre-verification request | String | pre_verification Info |
pre_verification.ip_address | IP address evaluated during pre-verification | String | pre_verification Info |
pre_verification.fraud_score | Fraud score returned by the pre-verification service | Number | pre_verification Info |
pre_verification.attempts_frequency | Subnet attempt frequency classification (FirstSeen, Rare, Frequent, VeryFrequent) | String | pre_verification Info |
pre_verification.country_code | Country code associated with the evaluated IP address | String | pre_verification Info |
pre_verification.connection_type | Connection type (Residential, Corporate, Education, Mobile, DataCenter) | String | pre_verification Info |
pre_verification.is_valid | Indicates whether pre-verification passed (true) or failed (false) | Boolean | pre_verification Info |
Signals Object and Confidence
Auxiliary data generated during submission processing is returned under thesignals object.
Confidence Object (signals.confidence) ⭐ NEW
Object that provides OCR recognition confidence scores. It includes a confidence score (0.0 ~ 1.0) per category. These values correspond to the per-field confidence shown in the dashboard submission detail view.
signals.confidence.finalData
Confidence scores for the final data used in Argos Score calculation.
| Field | Type | Description |
|---|---|---|
fullName | number | Full name confidence (0.0 ~ 1.0) |
firstName | number | First name confidence (0.0 ~ 1.0) |
lastName | number | Last name confidence (0.0 ~ 1.0) |
gender | number | Gender confidence (0.0 ~ 1.0) |
nationality | number | Nationality confidence (0.0 ~ 1.0) |
birthDate | number | Date of birth confidence (0.0 ~ 1.0) |
identityNumber | number | Identity number confidence (0.0 ~ 1.0) |
issueDate | number | Issue date confidence (0.0 ~ 1.0) |
expireDate | number | Expiry date confidence (0.0 ~ 1.0) |
licenseNumber | number | License number confidence (0.0 ~ 1.0) |
documentNumber | number | Document number confidence (0.0 ~ 1.0) |
serialNumber | number | Serial number confidence (0.0 ~ 1.0) |
curpNumber | number | CURP number confidence (0.0 ~ 1.0) |
typeOfPermit | number | Permit type confidence (0.0 ~ 1.0) |
signals.confidence.ocrData
Confidence scores for OCR-extracted data.
| Field | Type | Description |
|---|---|---|
fullName | number | Full name OCR confidence (0.0 ~ 1.0) |
birthDate | number | Date of birth OCR confidence (0.0 ~ 1.0) |
expireDate | number | Expiry date OCR confidence (0.0 ~ 1.0) |
issueDate | number | Issue date OCR confidence (0.0 ~ 1.0) |
gender | number | Gender OCR confidence (0.0 ~ 1.0) |
nationality | number | Nationality OCR confidence (0.0 ~ 1.0) |
documentNumber | number | Document number OCR confidence (0.0 ~ 1.0) |
identityNumber | number | Identity number OCR confidence (0.0 ~ 1.0) |
licenseNumber | number | License number OCR confidence (0.0 ~ 1.0) |
serialNumber | number | Serial number OCR confidence (0.0 ~ 1.0) |
curpNumber | number | CURP number OCR confidence (0.0 ~ 1.0) |
version | number | Version OCR confidence (0.0 ~ 1.0) |
typeOfPermit | number | Permit type OCR confidence (0.0 ~ 1.0) |
signals.confidence.ocrExtractedData
Confidence scores for data extracted directly from the source by the OCR engine.
The
ocrExtractedData property is not returned for Korean national ID cards and driver’s licenses.| Field | Type | Description |
|---|---|---|
rotate | number | Rotation angle confidence (0.0 ~ 1.0) |
birth_date | number | Date of birth confidence (0.0 ~ 1.0) |
date_of_birth | number | Date of birth confidence (0.0 ~ 1.0) |
emergency_name | number | Emergency contact name confidence (0.0 ~ 1.0) |
number | number | Document number confidence (0.0 ~ 1.0) |
height | number | Height confidence (0.0 ~ 1.0) |
restrictions | number | Restrictions confidence (0.0 ~ 1.0) |
weight | number | Weight confidence (0.0 ~ 1.0) |
emergency_address | number | Emergency address confidence (0.0 ~ 1.0) |
nationality | number | Nationality confidence (0.0 ~ 1.0) |
authority | number | Issuing authority confidence (0.0 ~ 1.0) |
name | number | Name confidence (0.0 ~ 1.0) |
gender | number | Gender confidence (0.0 ~ 1.0) |
audit_number | number | Audit number confidence (0.0 ~ 1.0) |
emergency_telephone | number | Emergency telephone confidence (0.0 ~ 1.0) |
eyes | number | Eye color confidence (0.0 ~ 1.0) |
donor | number | Donor status confidence (0.0 ~ 1.0) |
blood_type | number | Blood type confidence (0.0 ~ 1.0) |
first_name | number | First name confidence (0.0 ~ 1.0) |
address | number | Address confidence (0.0 ~ 1.0) |
expiry_date | number | Expiry date confidence (0.0 ~ 1.0) |
last_name | number | Last name confidence (0.0 ~ 1.0) |
middle_name | number | Middle name confidence (0.0 ~ 1.0) |
endorsements | number | Endorsements confidence (0.0 ~ 1.0) |
id_number | number | ID number confidence (0.0 ~ 1.0) |
serial_number | number | Serial number confidence (0.0 ~ 1.0) |
curp_number | number | CURP number confidence (0.0 ~ 1.0) |
version | number | Version confidence (0.0 ~ 1.0) |
type_of_permit | number | Permit type confidence (0.0 ~ 1.0) |
issue_date | number | Issue date confidence (0.0 ~ 1.0) |
birth_date_eng, birth_date_{country} | number | Country-specific date of birth confidence (0.0 ~ 1.0) |
expiry_date_eng, expiry_date_{country} | number | Country-specific expiry date confidence (0.0 ~ 1.0) |
issue_date_eng, issue_date_{country} | number | Country-specific issue date confidence (0.0 ~ 1.0) |
gender_eng, gender_{country} | number | Country-specific gender confidence (0.0 ~ 1.0) |
nationality_eng, nationality_{country} | number | Country-specific nationality confidence (0.0 ~ 1.0) |
mrz_birth_date, mrz_expiry_date, mrz_issue_date, mrz_gender, mrz_nationality | number | MRZ field confidence (0.0 ~ 1.0) |
- All confidence values are numbers in the range 0.0 ~ 1.0.
- Fields are included conditionally based on data presence and confidence values.
Response Field (Knowledge-based)
| Field Name | Description | Data Type | Category |
|---|---|---|---|
data | KYC applicant data | Object | KYC Applicant Info |
data.name | Name of the applicant | String | KYC Applicant Info |
data.gender | Gender of the applicant (male or female) | Enum | KYC Applicant Info |
data.nationality | Country code in ISO alpha-3 format | String | KYC Applicant Info |
data.date_of_birth | Date of birth in YYYY-MM-DD format | Date | KYC Applicant Info |
data.address_formatted | Converted detailed address | String | KYC Applicant Info |
data.address_detail | Detailed user-inputted address | String | KYC Applicant Info |
data.ssnNumber | Social Security number | String | KYC Applicant Info |
data.phoneNumber | Phone number | String | KYC Applicant Info |
data.cf1 | Custom field 1 optionally added during submission | String | KYC Applicant Info |
data.cf2 | Custom field 2 optionally added during submission | String | KYC Applicant Info |
data.cf3 | Custom field 3 optionally added during submission | String | KYC Applicant Info |
email | Email address associated with the submission | String | KYC Applicant Info |
reviewer | Reviewer Type system indicates AI system review, agent indicates human review | Enum | KYC Review Info |
submission_id | Unique identifier assigned to each submission | String | Submission Info |
duplicated_information | A unique ID is generated based on name, date of birth, gender, and nationality for duplicate checks. (*Always generated when all four criteria are provided.) | String | Submission Info |
created_at | Date and time of submission (UTC+0) | String | Submission Info |
kyc_result_at | Date and time when the KYC result was finalized | String | Submission Info |
updated_at | Date and time when the submission was last updated | String | Submission Info |
pending_at | Date and time when the KYC submission was marked pending | String | Submission Info |
userid | Optional parameter added when creating a submission | String | Submission Info |
additional_list | User-inputted data for additional forms configured in the dashboard | Array | Additional Form Info |
additional_list.answer | Name of each additional form field | String | Additional Form Info |
additional_list.inputValue | User-inputted value for each field | String | Additional Form Info |
additional_list.blockType | Data type for each additional form field | String | Additional Form Info |
kyc | Object containing KYC results KYC Status | Object | KYC Result Info |
kyc.result | Status of the KYC process | Enum | KYC Result Info |
kyc.comment | Reason for KYC rejection Reject Codes and Comments | String | KYC Result Info |
kyc.commentCode | Code representing the reason for KYC rejection Reject Codes and Comments | String | KYC Result Info |
kyc.attempts[i].attemptCnt | Number of retries after failed submissions | Number | KYC Attempt Info |
kyc.attempts[i].errorCode | Error code generated during liveness, face detection, face comparison, or ID verification | String | KYC Attempt Info |
kyc.attempts[i].errorMsg | Error message generated during liveness, face detection, face comparison, or ID verification | String | KYC Attempt Info |
kyc.attempts[i].step1Time1st | Timestamp of the first call to step1 | String | KYC Attempt Info |
kyc.attempts[i].step1Time2nd | Timestamp of the second call to step1 | String | KYC Attempt Info |
kyc.attempts[i].step1Time3rd | Timestamp of the third call to step1 | String | KYC Attempt Info |
kyc.attempts[i].step2Time1st | Timestamp of the first call to step2 | String | KYC Attempt Info |
kyc.attempts[i].step2Time2nd | Timestamp of the second call to step2 | String | KYC Attempt Info |
kyc.attempts[i].step2Time3rd | Timestamp of the third call to step2 | String | KYC Attempt Info |
kyc.attempts[i].retryMsg | Failure reason messages generated during liveness, face detection, face comparison, or ID verification | String | KYC Attempt Info |
kyc.attempts[i].retryCode | Failure reason codes generated during liveness, face detection, face comparison, or ID verification | String | KYC Attempt Info |
kyc.attempts[i].faceSimilarityScore | Face comparison similarity score | Float | KYC Attempt Info |
kyc.attempts[i].selfieImage | URL of the submitted selfie image | String | KYC Attempt Info |
kyc.attempts[i].livenessScore | Liveness score for the attempt | Float | KYC Attempt Info |
kyc.attempts[i].liveness | Detailed liveness metrics including score, probability, and quality | Object | KYC Attempt Info |
kyc.attempts[i].liveness.score | Overall liveness score | Float | KYC Attempt Info |
kyc.attempts[i].liveness.probability | Probability value for liveness | Float | KYC Attempt Info |
kyc.attempts[i].liveness.quality | Quality score for liveness | Float | KYC Attempt Info |
kyc.attempts[i].detectFace | Array containing face detection results (AWS Rekognition DetectFaces API response) | Array | Face Detection Info |
kyc.attempts[i].detectFace.AgeRange | Age range information of detected face | Object | Face Detection Info |
kyc.attempts[i].detectFace.AgeRange.High | Highest estimated age of detected face | Number | Face Detection Info |
kyc.attempts[i].detectFace.AgeRange.Low | Lowest estimated age of detected face | Number | Face Detection Info |
kyc.attempts[i].detectFace.Gender.Confidence | Gender detection confidence level (0~100) | Float | Face Detection Info |
kyc.attempts[i].detectFace.Gender.Value | Detected gender (Male, Female) | String | Face Detection Info |
verification | Object containing face-based age verification results | Object | Face Age Verification Info |
verification.faceAge | Complete results array of face-based age verification (cumulative record per attempt) | Array | Face Age Verification Info |
verification.faceAge[i].usedValues | Age values used in verification | Object | Face Age Verification Info |
verification.faceAge[i].usedValues.originalSelfieLow | Lowest age estimate of selfie image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.originalSelfieHigh | Highest age estimate of selfie image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.originalSelfieMedian | Median age estimate of selfie image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.originalIdLow | Lowest age estimate of ID image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.originalIdHigh | Highest age estimate of ID image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.originalIdMedian | Median age estimate of ID image before LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.selfieLow | Lowest age estimate of selfie image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.selfieHigh | Highest age estimate of selfie image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.selfieMedian | Median age estimate of selfie image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.idLow | Lowest age estimate of ID image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.idHigh | Highest age estimate of ID image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.idMedian | Median age estimate of ID image after LOW/HIGH extension settings applied | Number | Face Age Verification Info |
verification.faceAge[i].usedValues.birthDateAge | Age calculated from user-input date of birth | Number | Face Age Verification Info |
verification.faceAge[i].conditionResults | Verification result array for each condition | Array | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].condition | Condition setting information | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].condition.comparisonOperator | Comparison operator (gte: greater than or equal, gt: greater than, lte: less than or equal, lt: less than) | String | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].condition.target | Target age type for comparison (low, high, median) | String | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].conditionIndex | Condition index (starting from 0) | Number | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].finalResult | Final verification result of the condition (true: success, false: failure) | Boolean | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults | Comparison results for each target image and reference age combination | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.idCardCustomMatch | Comparison result between ID image and custom age value | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.idCardBirthDateMatch | Comparison result between ID image and birth date age | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.faceImageCustomMatch | Comparison result between selfie image and custom age value | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.faceImageBirthDateMatch | Comparison result between selfie image and birth date age | Object | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.*.result | Success/failure result of individual comparison (true: success, false: failure, null: when absent) | Boolean | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.*.processed | Whether the comparison was executed (true: success, false: failure) | Boolean | Face Age Verification Info |
verification.faceAge[i].conditionResults[j].matchResults.*.statement | Specific content of comparison operation (e.g., “36 gte 18”) | String | Face Age Verification Info |
verification.faceAge[i].logicalOperators | Logical operator array between conditions (and, or) | Array | Face Age Verification Info |
signals | Object containing auxiliary data generated during submission processing (face age, camera process, OCR confidence, etc.) | Object | Face Detection Info |
signals.confidence | OCR recognition confidence score object. Confidence (0.0~1.0) per category. Corresponds to per-field confidence in dashboard submission detail. ⭐ NEW | Object | OCR Confidence Info |
signals.confidence.finalData | Confidence scores (0.0~1.0) for final data used in Argos Score calculation | Object | OCR Confidence Info |
signals.confidence.ocrData | Confidence scores (0.0~1.0) for OCR-extracted data | Object | OCR Confidence Info |
signals.confidence.ocrExtractedData | Confidence scores (0.0~1.0) for data extracted directly from the source by the OCR engine. Not returned for Korean national ID and driver’s license. | Object | OCR Confidence Info |
signals.faceAge | Age range information array extracted from faces (cumulative record per attempt) | Array | Face Detection Info |
signals.faceAge[i].ageRange | Age range detected in the attempt | Object | Face Detection Info |
signals.faceAge[i].ageRange.low | Detected lowest age estimate | Number | Face Detection Info |
signals.faceAge[i].ageRange.high | Detected highest age estimate | Number | Face Detection Info |
signals.faceAge[i].ageRange.median | Detected median age estimate | Number | Face Detection Info |
signals.faceAge[i].source | Age estimation source image type (selfieImage, idImage) | String | Face Detection Info |
signals.startButtonClickTime | Timestamp when the user clicked the start button (ISO 8601 format) | String | Camera Process Info |
signals.cameraProcessInfo | Array of camera operation data | Array | Camera Process Info |
signals.cameraProcessInfo[i].type | Process type (e.g., knowledge-face-passive, knowledge-face-active, etc.) | String | Camera Process Info |
signals.cameraProcessInfo[i].processStartTime | Timestamp when the process started (ISO 8601 format) | String | Camera Process Info |
signals.cameraProcessInfo[i].processEndTime | Timestamp when the process ended (ISO 8601 format) | String | Camera Process Info |
signals.cameraProcessInfo[i].error | Error that occurred during the process (null if no error) | String | Camera Process Info |
aml | Object containing AML screening result data | Object | AML Screening Info |
aml.raw_data | Object containing raw AML screening results | Object | AML Screening Info |
aml.risk_level_summary | Summary of the risk level (Not Screened, High, Medium, Low)Risk Level | Enum | AML Screening Info |
aml.currentstatus | Current AML screening status (Not Screened, Red Flag)AML Screening Status | Enum | AML Screening Info |
aml.matches | Detailed AML screening results (only available when aml.currentstatus is Red Flag)AML Screening Info | Array | AML Screening Info |
aml.matches[i].risk_level | Risk level of the Red Flag (HIGH, MEDIUM, LOW) Risk Level | Enum | AML Screening Info |
aml.matches[i].argos_number | Unique ID for retrieving the AML report | String | AML Screening Info |
aml.matches[i].resource_id | Unique resource ID for retrieving the AML report | String | AML Screening Info |
aml.matches[i].score | AML screening match score | Float | AML Screening Info |
aml.matches[i].risk_icons | Risk icons for the AML screening | Array | AML Screening Info |
nextpageKey | Key object provided when additional pages of results are available | Object | Pagination Info |
nextpageKey.id | ID of the last submission retrieved, required for fetching the next page | String | Pagination Info |
nextpageKey.created_at | Timestamp of the last submission retrieved, required for fetching the next page | String | Pagination Info |
projection | The object contains submission projection data | Object | Projection Info |
projection.projectionId | The projection ID into applied submission * If the submission created a projection ID, only the ID is shown. | String | Projection Info |
projection.projectionName | Applied submission projection name * If the submission created a projection name, only the name is shown. | String | Projection Info |
tokenId | Token ID used for live-form submissions in private mode | String | Submission Info |
pre_verification | List of pre-verification objects | Object | pre_verification Info |
pre_verification.request_id | Request id of pre_verification | String | pre_verification Info |
pre_verification.created_at | Request Timestamp | String | pre_verification Info |
pre_verification.ip_address | Request IP address | String | pre_verification Info |
pre_verification.fraud_score | Fraud score | Number | pre_verification Info |
pre_verification.attempts_frequency | Frequency of Subnet trials: [0=‘FirstSeen’, 1 | String | pre_verification Info |
pre_verification.country_code | Country code of requested IP address | String | pre_verification Info |
pre_verification.connection_type | Connect type: [‘Residential’, ‘Corporate’, ‘Education’, ‘Mobile’, ‘DataCenter’] | String | pre_verification Info |
pre_verification.is_valid | Status of pre_verification whether it is fail or pass | Boolean | pre_verification Info |
Camera Process Type Details
Additional data generated during the process is returned under thesignals object. The type field in the signals.cameraProcessInfo array indicates the method used by the user to submit images at each process stage.
1. ID Document Processing
1. ID Document Processing
Process types that define how ID document images are captured.
1.1 ID Document Front (ProcessIdCardFront)
Defines the method for capturing the front of an ID document.| Type | Description |
|---|---|
idcard-front-upload | File upload method - User selects and uploads an ID document front image file stored on their device |
idcard-front-capture | Capture method - User captures the ID document front in real-time using the camera, controlling the capture timing |
idcard-front-autocapture | Auto-capture method - Automatically captures when the ID document is detected by the camera, triggering when conditions like position, angle, and focus are met |
1.2 ID Document Back (ProcessIdCardBack)
Defines the method for capturing the back of an ID document.| Type | Description |
|---|---|
idcard-back-upload | File upload method - User selects and uploads an ID document back image file stored on their device |
idcard-back-capture | Capture method - User captures the ID document back in real-time using the camera, controlling the capture timing |
idcard-back-autocapture | Auto-capture method - Automatically captures when the ID document is detected by the camera, triggering when conditions like position, angle, and focus are met |
2. Face Authentication Processing
2. Face Authentication Processing
Process types that define how face images are captured for authentication.
2.1 ID Document Face Authentication (IdDocumentFace)
Defines the method for capturing a face image to compare with the face registered on the ID document.| Type | Description |
|---|---|
id-document-face-passive | Passive method - Captures the user’s face in a natural state through the camera, requiring only a frontal face without specific gestures or expressions |
id-document-face-active | Active method - Captures the user’s face while performing specific actions through the camera |
2.2 Knowledge-Based Face Authentication (KnowledgeFace)
Defines the method for capturing a face image to compare with previously registered face information.| Type | Description |
|---|---|
knowledge-face-passive | Passive method - Captures the user’s face in a natural state through the camera |
knowledge-face-active | Active method - Captures the user’s face while performing specific actions through the camera |
The
signals.cameraProcessInfo array sequentially records all process stages the user went through during submission. You can track the user’s submission journey through the start time, end time, and error information of each process.