GET/Submission (다수 건 목록)

이 API를 사용하면 제출된 ID Check 데이터를 조회할 수 있습니다. 특정 제출 건의 상세 정보를 확인하거나 여러 제출 건의 목록을 필터링하여 가져올 수 있습니다.

본 메소드는 다수의 목록을 가져옵니다. 하지만, 단일 건에서만 보이는 field들에 대한 정의가 내려져 있습니다. 다수 건 목록 시, 빠져있는 field들에 대해선, 단일 건 조회로 확인할 수 있습니다. 단일 건만 가저오는 메소드 호출 방법은 여기를 참조해주세요.

​

1. 엔드포인트

GET/Submission

GET https://rest-api.argosidentity.com/v3/submission

​

2. 인증

x-api-key 헤더에 API 키를 포함시켜야 합니다:

x-api-key

x-api-key: {yourAPIKey}

​

3. 요청 파라미터

요청 파라미터는 URL query 형식이어야 합니다. 각 파라미터에 대한 설명은 다음과 같습니다.

submission_id · string

특정 제출 건의 고유 ID; (단일 건 조회)

userid · string

사용자 ID와 일치하는 목록 조회

email · string

이메일 주소와 일치하는 제출 목록 조회

count · string

반환할 결과의 수 (기본값: 50)

nextpage_id · string

다음 페이지 조회를 위한 ID

nextpage_date · string

다음 페이지 조회를 위한 날짜

start_date · string

조회 시작 날짜 (YYYY-MM-DD)

end_date · string

조회 종료 날짜 (YYYY-MM-DD)

request_type · string

request_type 파라미터를 사용하여 특정 데이터 유형만 선택적으로 조회할 수 있습니다. 다음 옵션 중 하나를 선택하여 입력할 수 있습니다:

• kyc: KYC 관련 데이터와 submission_id를 반환합니다.
• aml: AML 관련 데이터와 submission_id를 반환합니다.
• data: 제출자의 개인 정보 데이터와 submission_id를 반환합니다.
• others: KYC, AML, 개인 정보를 제외한 나머지 모든 데이터 항목을 반환합니다.

​

4. 요청 예시

GET/Submission

curl --location 'https://rest-api.argosidentity.com/v3/submission?submission_id={submission_id}' \
--header 'x-api-key: {yourAPIKey}'

​

4.1 안전한 데이터 전송을 위한 요청 예시

submission_id를 포함한 전체 데이터 객체를 암호화하여 data 쿼리 파라미터로 전달해야 합니다. 자세한 내용은 쿼리 문자열 암호화 페이지를 참조하세요.

GET/Submission

curl --location 'https://rest-api.argosidentity.com/v3/submission?data={encrypted_data}' \
--header 'x-api-key: {yourAPIKey}'

안전한 데이터 전송을 사용할 경우 응답이 암호화된 데이터로 반환되며, 데이터를 읽기 위해 복호화해야 합니다.

​

5. 응답

​

5-1. 성공 응답

result-id-document.json

{
    "Items": [
        {
            "data": {
                "age_group": "{age group}",
                "first_name": "{first name}",
                "last_name": "{last name}",
                "full_name": "{full name}",
                "gender": "male",
                "nationality": "USA",
                "date_of_birth": "YYYY-MM-DD",
                "address_city": "{city}",
                "address_country": "KOR",
                "address_state": "{state}",
                "address_street": "{street}",
                "address_street2": "{street2}",
                "address_zipcode": "{zipcode}",
                "ip_address": "{ip_address}",
                "idcard_issuingCountry": "USA",
                "idcard_issueDate": "YYYY-MM-DD",
                "idType": "drivers_license",
                "documentNumber": "{********}",
                "typeOfPermit": "{F-1}",
            },
            "OCR_raw": {
                "rotate": {
                    "value": "0"
                },
                "address": {
                    "value": "John Smith, 123 Elm Street, town, CA 91234, USA",
                    "score": 96,
                    "accepted": true,
                    "coordinates": {coordinates_object}
                    }
                }...
            },
            "ocr": {
                "birthDate": "YYYY-MM-DD",
                "expireDate": "YYYY-MM-DD",
                "firstName": "{first name}","fullName": "{full name}",
                "identityNumber": "{identity number}",
                "lastName": "{last name}",
                "nationality": "USA"
                },
            "verification": {
                "faceAge": [
                    {
                        "usedValues": {
                            "originalSelfieLow": 24, 
                            "originalSelfieHigh": 30,
                            "idMedian": 25, 
                            "birthDateAge": 34,
                            "idHigh": 36,
                            "selfieMedian": 33,
                            "originalSelfieMedian": 27,
                            "idLow": 15, 
                            "originalIdMedian": 19,
                            "selfieLow": 23,
                            "originalIdLow": 16,
                            "selfieHigh": 44,
                            "originalIdHigh": 22
                        },
                        "conditionResults": [
                            {
                                "condition": {
                                    "comparisonOperator": "gte",
                                    "target": "high"
                                },
                                "matchResults": {
                                    "idCardCustomMatch": {
                                        "result": true,
                                        "processed": true,
                                        "statement": "36 gte 18"
                                    },
                                "faceImageBirthDateMatch": {
                                    "result": true,
                                    "processed": true,
                                    "statement": "44 gte 34"
                                },
                                "faceImageCustomMatch": {
                                    "result": true,
                                    "processed": true,
                                    "statement": "44 gte 18"
                                },
                                "idCardBirthDateMatch": {
                                    "result": true,
                                    "processed": true,
                                    "statement": "36 gte 34"
                                }
                            },
                            "conditionIndex": 0,
                            "finalResult": true
                        },
                        {
                            "condition": {
                                "comparisonOperator": "gte",
                                "target": "median"
                            },
                            "matchResults": {
                                "idCardCustomMatch": {
                                    "result": true,
                                    "processed": true,
                                    "statement": "25 gte 18"
                                },
                                "faceImageBirthDateMatch": {
                                    "result": false,
                                    "processed": true,
                                    "statement": "33 gte 34"
                                },
                                "faceImageCustomMatch": {
                                    "result": true,
                                    "processed": true,
                                    "statement": "33 gte 18"
                                },
                                "idCardBirthDateMatch": {
                                    "result": false,
                                    "processed": true,
                                    "statement": "25 gte 34"
                                }
                            },
                            "conditionIndex": 1,
                            "finalResult": false
                        }
                        ],
                        "logicalOperators": [
                            "or"
                        ]
                    }
                    ]
                },
            "signals": {
                "faceAge": [
                {
                    "ageRange": {
                    "high": 33,
                    "median": 29,
                    "low": 25
                    },
                    "source": "selfieImage"
                }
                ],
                "cameraProcessInfo": [
                    {
                        "processStartTime": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "processEndTime": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "type": "idcard-front-capture",
                        "error": null
                    },
                    {
                        "processStartTime": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "processEndTime": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "type": "idcard-back-capture",
                        "error": null
                    },
                    {
                        "processStartTime": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "processEndTime": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "type": "id-document-face-active",
                        "error": null
                    }                                        
                ],
                "startButtonClickTime": "YYYY-MM-DD-HH-MM-SS-ZZZ"
            },            
            "updateHistory": {
                "updateAdmin": "{admin's email}",
                "updateTime": "YYYY-MM-DD-HH-MM-SS-ZZZ"
            },            
            "review": {
                "birthDate": "YYYY-MM-DD",
                "fullName": "DANYA ESTEPHANY PARRA ROSAS",
                "gender": "female",
                "nationality": "USA"
                },
            "duplicated_users": ["submission_id_1","submissid_id_2"],
            "duplicated_selfie_users": ["submission_id_1","submissid_id_2"],
            "email": "{email}",
            "submission_id": "{submission_id}",
            "recognition_score": "{recognition_score}",
            "argos_score": "{argos_score}",
            "image": {
                "idImage": "{idImage from ArgosServer}",
                "idBackImage": "{idBackImage from ArgosServer}",
                "selfieImage": "{selfieImage from ArgosServer}",
                "addressImage": "{addressImage from ArgosServer}"
                },
            "memo": {
                "text":"dashboard memo",
	            "updated_at":"YYYY-MM-DD-HH-MM-SS-ZZZ",
            },
            "duplicated_information": "{duplicated_information}",
            "custom_duplicated_information": "{custom_duplication_information}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "updated_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "reviewer": "{reviewer}",
            "Injection_action": [
                {
                    "attemptStatus": "success",
                    "createTime": "{create_time}",
                    "userInput": {
                        "ipAddress": "{ip_address}",
                        "address": {
                            "globalCode": "{global_code}",
                            "compoundCode": "{compound_code}",
                            "formatted_address": "{formatted_address}"
                        }
                    },
                    "option": {
                        "distanceChecks": [
                            {
                                "maxDistanceKm": 200,
                                "source": "ipGeo"
                            }
                        ],
                        "ipRisk": {
                            "durationHour": 8,
                            "failCategory": [
                                "vpn",
                                "proxy",
                                "tor"
                            ]
                        }
                    },
                    "ipVerification": {
                        "requestId": "{request_id}",
                        "status": "success",
                        "ip": "{ip_address}"
                    }
                }
            ],
            "aml": {
                "raw_data": {...},
                "matches": [...],
                "risk_level_summary": "HIGH",
                "currentstatus": "Red Flag"
            },
            "kyc": {
                "result": "rejected",
                "comment": [
                    "Multiple invalid KYC attempts"
                ],
                "commentCode": [
                    "too_many_retry"
                ],
                "attempts": [
                    {
                        "attemptCnt": 1,
                        "step1Time1st": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "ocrResult": "success",
                        "retryMsg": [
                            "Failed to read PDF417 Barcode."
                        ],
                        "idBarcodeResult": "fail",
                        "retryCode": [
                            "barcode_protocol_fail"
                        ]                    
                    },
                    {
                        "attemptCnt": 2,
                        "liveness": {
                            "score": 1.1610267,
                            "probability": 0.76151925,
                            "quality": 0.5903906
                        },
                        "faceSimilarityScore": 84,
                        "retryMsg": [
                            "The face doesn’t match. Please retry with another face image."
                        ],
                        "selfieImage": "{selfieImage URL}",
                        "livenessScore": 76,
                        "step2Time2nd": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "retryCode": [
                            "face_compare_underscore"
                        ]
                    },
                    {
                        "attemptCnt": 3,
                        "liveness": {
                            "error": "Failed to detect face",
                            "error_code": "FACE_NOT_FOUND"
                        },
                        "retryMsg": [
                            "Liveness fail: Failed to detect face."
                        ],
                        "selfieImage": "{selfieImage URL}",
                        "step2Time3rd": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "retryCode": [
                            "liveness_error"
                        ]
                    }
                ],
                "retry": [
                    {
                        "type": "step1",
                        "retryCnt": 1,
                        "retryCode": "barcode_protocol_fail",
                        "retryMessage": "Failed to read PDF417 Barcode."
                    },
                    {
                        "type": "step2",
                        "retryCnt": 2,
                        "retryCode": "face_compare_underscore",
                        "retryMessage": "The face doesn't match. Please retry with another face image."
                    },
                    {
                        "type": "step2",
                        "retryCnt": 3,
                        "retryCode": "liveness_error",
                        "retryMessage": "Liveness fail: Failed to detect face."
                    }
                ]
            },
            "pre_verification":{
                "request_id":"id______",
                "created_at":"YYYY-MM-DD-HH-MM-SS-ZZZ",
                "ip_address":"XXX.xx.xx.x", 
                "fraud_score":84,
                "attempts_frequency":"FirstSeen",
                "country_code": "KOR",
                "connection_type": "Mobile",
                "is_valid":true 
            }            
        }
    ]
}

​

5-2-a. 응답 데이터 (ID Document)

필드명	설명	데이터 타입	카테고리
data	KYC 제출자 데이터	Object	KYC 제출자 정보
data.age_group	제출자의 연령대: minor, early-teen, teen, adult	String	KYC 제출자 정보
data.first_name	제출자의 First Name	String	KYC 제출자 정보
data.last_name	제출자의 Last Name	String	KYC 제출자 정보
data.full_name	제출자의 Full Name	String	KYC 제출자 정보
data.gender	제출자의 성별 (male 또는 female)	Enum	KYC 제출자 정보
data.nationality	ISO alpha-3 형식의 국가 코드	String	KYC 제출자 정보
data.date_of_birth	제출자의 생년월일 (YYYY-MM-DD 형식)	Date	KYC 제출자 정보
data.ip_address	IPv4 형식의 IP 주소	String	KYC 제출자 정보
data.idType	사용된 신분증 유형	Enum	KYC 제출자 정보
data.idcard_issuingCountry	신분증 발급 국가의 ISO alpha-3 형식 코드 ISO Alpha-3 국가 코드	String	KYC 제출자 정보
data.idcard_issueDate	신분증 발급일 (YYYY-MM-DD 형식)	String	KYC 제출자 정보
data.idcard_expireDate	신분증 만료일 (YYYY-MM-DD 형식)	String	KYC 제출자 정보
data.identityNumber	주민등록번호	String	KYC 제출자 정보
data.documentNumber	신분증 번호	String	KYC 제출자 정보
data.address_city	도시	String	KYC 제출자 정보
data.address_country	국가	String	KYC 제출자 정보
data.address_state	주	String	KYC 제출자 정보
data.address_street	도로	String	KYC 제출자 정보
data.address_zipcode	우편번호	String	KYC 제출자 정보
data.address_globalCode	글로벌 주소 코드 (예: 8Q98HXPG+MP)	String	KYC 제출자 정보
data.address_compoundCode	복합 주소 코드 (예: HXPG+MP 서울, 대한민국)	String	KYC 제출자 정보
data.address_formatted	변환된 상세 주소	String	KYC 제출자 정보
data.address_input	사용자가 입력한 주소	String	KYC 제출자 정보
data.address_detail	사용자가 입력한 상세 주소	String	KYC 제출자 정보
data.cf1	사용자 정의 필드 #1	String	KYC 제출자 정보
data.cf2	사용자 정의 필드 #2	String	KYC 제출자 정보
data.cf3	사용자 정의 필드 #3	String	KYC 제출자 정보
data.typeOfPermit	신분증에 부여된 제출자의 체류자격이나 종류	String	KYC 제출자 정보
image	ArgosServer에서 ID 문서 및 셀피에 대한 이미지 링크를 포함하는 이미지 객체; GET/Image를 사용해서만 이미지를 다운로드할 수 있음	Object	제출 정보
image.idImage	ArgosServer의 ID 문서 이미지 링크; 이미지를 다운로드할 수 없음	String	제출 정보
image.idBackImage	ArgosServer의 ID 문서 뒷면 이미지 링크; 이미지를 다운로드할 수 없음	String	제출 정보
image.selfieImage	ArgosServer의 셀피 이미지 링크; 이미지를 다운로드할 수 없음	String	제출 정보
image.addressImage	ArgosServer의 주소 문서 이미지 링크; 이미지를 다운로드할 수 없음	String	제출 정보
memo	대시보드 제출 메모 객체	Object	대시보드 정보
memo.text	대시보드 제출 메모 내용	string	대시보드 정보
memo.updated_at	대시보드 제출 메모 업데이트 시간	string	대시보드 정보
duplicated_users	중복된 PII를 가진 것으로 발견된 제출 ID 목록	Array	KYC 제출자 정보
duplicated_selfie_users	중복된 얼굴을 가진 것으로 발견된 제출 ID 목록	Array	KYC 제출자 정보
OCR_raw.rotate.value	OCR 이 인식된 각도	String	KYC 제출자 정보
OCR_raw.{item}.value	인식된 OCR 의 값	String	KYC 제출자 정보
OCR_raw.{item}.score	인식률 점수 (0~100)	Int	KYC 제출자 정보
OCR_raw.{item}.accepted	인식 성공 여부	Bool	KYC 제출자 정보
OCR_raw.{item}.coordinates	인식된 OCR 의 벡터 데이터	Object	KYC 제출자 정보
ocr.birthDate	OCR 인식 제출자의 생년월일 (YYYY-MM-DD 형식)	Date	KYC 제출자 정보
ocr.issueDate	OCR 인식 발급일자	Date	KYC 제출자 정보
ocr.expireDate	OCR 인식 만료일자	Date	KYC 제출자 정보
ocr.firstName	OCR 인식 제출자의 First Name	String	KYC 제출자 정보
ocr.lastName	OCR 인식 제출자의 Last Name	String	KYC 제출자 정보
ocr.fullName	OCR 인식 제출자의 Full Name	String	KYC 제출자 정보
ocr.gender	OCR 인식 제출자의 성별 ( male 또는 female )	Enum	KYC 제출자 정보
ocr.number	OCR 인식 문서번호 (Document Number)	String	KYC 제출자 정보
ocr.licenseNumber	OCR 인식 면허번호	String	KYC 제출자 정보
ocr.identityNumber	OCR 인식 주민등록번호	String	KYC 제출자 정보
ocr.curpNumber	OCR 인식 MEX.ID 의 Curp Number	String	KYC 제출자 정보
ocr.nationality	OCR 인식 ISO alpha-3 형식의 국가 코드	String	KYC 제출자 정보
ocr.serialNumber	OCR 인식 일련번호	String	KYC 제출자 정보
review.birthDate	제출자의 생년월일 (YYYY-MM-DD 형식)	Date	KYC 제출자 정보
review.issueDate	발급일자	Date	KYC 제출자 정보
review.expireDate	만료일자	Date	KYC 제출자 정보
review.fullName	제출자의 Full Name	String	KYC 제출자 정보
review.gender	제출자의 성별 ( male 또는 female )	Enum	KYC 제출자 정보
review.nationality	ISO alpha-3 형식의 국가 코드	String	KYC 제출자 정보
review.documentNumber	문서번호	String	KYC 제출자 정보
review.licenseNumber	면허번호	String	KYC 제출자 정보
review.identityNumber	주민등록번호	String	KYC 제출자 정보
review.curpNumber	MEX.ID 의 Curp Number	String	KYC Applicant Info
email	제출과 연관된 이메일 주소	String	KYC 제출자 정보
reviewer	검수 유형: system은 AI 시스템 검수, agent는 사람 검수를 나타냄	Enum	KYC 검수 정보
Injection_action.attemptStatus	Injection 시도 결과	String	KYC injection 정보
Injection_action.createTime	Injection 생성일시 (UTC+0) *순서: 최신이 최상단, 이후 오래된 순서 정렬	String	KYC injection 정보
Injection_action.userInput.address	유저가 입력한 주소 정보	Object	KYC injection 정보
Injection_action.option.distanceChecks	Injection 거리 측정에 사용된 서비스와 거리 정보	Object	KYC injection 정보
Injection_action.option.ipRisk	IP 위험 평가 카테고리 및 차단 시간 정보	Object	KYC injection 정보
Injection_action.option.ipVerification	Injection 진행 시 확인된 IP 정보	Object	KYC injection 정보
submission_id	각 제출 건에 부여된 고유 식별자	String	제출 정보
recognition_score	신분증 인식 점수	Float	제출 정보
argos_score	ARGOS 시스템의 종합 평가 점수	Float	제출 정보
duplicated_information	이름, 생년월일, 성별, 국적을 기준으로 중복 확인용 식별자가 생성됩니다. (*네 가지 기준이 모두 제공되면 항상 생성됩니다.)	String	제출 정보
applicant_id	중복 제출된 사용자에 부여된 식별자	String	제출 정보
created_at	제출된 날짜와 시간 (UTC+0)	String	제출 정보
kyc_result_at	KYC 결과가 최종적으로 결정된 날짜와 시간	String	제출 정보
updated_at	마지막으로 제출 정보가 업데이트된 날짜와 시간	String	제출 정보
pending_at	KYC가 보류(Pending) 상태로 표시된 날짜와 시간	String	제출 정보
userid	제출 생성 시 선택적으로 추가된 파라미터	String	제출 정보
additional_list	대시보드에서 설정된 추가 양식에 대해 사용자가 입력한 데이터	Array	추가 양식 정보
additional_list.answer	각 추가 양식 필드의 이름	String	추가 양식 정보
additional_list.inputValue	각 필드에 대한 사용자 입력 값	String	추가 양식 정보
additional_list.blockType	각 추가 양식 필드의 데이터 타입	String	추가 양식 정보
kyc	KYC 결과를 포함하는 객체 KYC 상태	Object	KYC 결과 정보
kyc.result	KYC 프로세스의 상태	Enum	KYC 결과 정보
kyc.comment	KYC 거절 사유 거절 코드 및 사유	String	KYC 결과 정보
kyc.commentCode	KYC 거절 사유를 나타내는 코드 거절 코드 및 사유	String	KYC 결과 정보
kyc.attempts[i].attemptCnt	실패 후 재시도한 횟수	Number	KYC 시도 정보
kyc.attempts[i].idBarcodeResult	미국, 캐나다, 멕시코 신분증의 바코드 검증 결과	String	KYC 시도 정보
kyc.attempts[i].verificationResult	신분증 진위 확인 결과 (success, fail)	Enum	KYC 시도 정보
kyc.attempts[i].verification	신분증 진위 확인 결과의 상세 데이터	Object	KYC 시도 정보
kyc.attempts[i].verificationParams	신분증 진위 확인 실행 시 필요한 매개변수	Object	KYC 시도 정보
kyc.attempts[i].errorCode	얼굴 인식, 비교, 신분증 진위 확인 중 발생한 오류 코드	String	KYC 시도 정보
kyc.attempts[i].errorMsg	얼굴 인식, 비교, 신분증 진위 확인 중 발생한 오류 메시지	String	KYC 시도 정보
kyc.attempts[i].step1Time1st	step1 첫 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].step1Time2nd	step1 두 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].step1Time3rd	step1 세 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].step2Time1st	step2 첫 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].step2Time2nd	step2 두 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].step2Time3rd	step2 세 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].retryMsg	얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 메시지	String	KYC 시도 정보
kyc.attempts[i].retryCode	얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 코드	String	KYC 시도 정보
kyc.attempts[i].faceSimilarityScore	얼굴 비교 유사도 점수	Float	KYC 시도 정보
kyc.attempts[i].selfieImage	제출된 셀피 이미지의 URL	String	KYC 시도 정보
kyc.attempts[i].livenessScore	시도의 생체 인증 점수	Float	KYC 시도 정보
kyc.attempts[i].liveness	생체 인증 점수의 상세 데이터 (score, probability, quality 포함)	Object	KYC 시도 정보
kyc.attempts[i].liveness.score	생체 인증의 전체 점수	Float	KYC 시도 정보
kyc.attempts[i].liveness.probability	생체 인증의 확률 값	Float	KYC 시도 정보
kyc.attempts[i].liveness.quality	생체 인증의 품질 점수	Float	KYC 시도 정보
verification	얼굴 기반 나이 검증 결과를 포함하는 객체	Object	얼굴 나이 검증 정보
verification.faceAge	얼굴 기반 나이 검증의 전체 결과 배열 (매 시도별 누적 기록)	Array	얼굴 나이 검증 정보
verification.faceAge[i].usedValues	검증에 사용된 나이 값들	Object	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieLow	LOW/HIGH 확장 설정 적용 전 셀피 이미지의 최저 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieHigh	LOW/HIGH 확장 설정 적용 전 셀피 이미지의 최고 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieMedian	LOW/HIGH 확장 설정 적용 전 셀피 이미지의 중간 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdLow	LOW/HIGH 확장 설정 적용 전 신분증 이미지의 최저 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdHigh	LOW/HIGH 확장 설정 적용 전 신분증 이미지의 최고 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdMedian	LOW/HIGH 확장 설정 적용 전 신분증 이미지의 중간 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieLow	LOW/HIGH 확장 설정 적용 후 셀피 이미지의 최저 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieHigh	LOW/HIGH 확장 설정 적용 후 셀피 이미지의 최고 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieMedian	LOW/HIGH 확장 설정 적용 후 셀피 이미지의 중간 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idLow	LOW/HIGH 확장 설정 적용 후 신분증 이미지의 최저 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idHigh	LOW/HIGH 확장 설정 적용 후 신분증 이미지의 최고 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idMedian	LOW/HIGH 확장 설정 적용 후 신분증 이미지의 중간 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.birthDateAge	사용자 입력 생년월일로 계산한 만 나이	Number	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults	각 조건식별 검증 결과 배열	Array	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].condition	조건식 설정 정보	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].condition.comparisonOperator	비교 연산자 (gte: 이상, gt: 초과, lte: 이하, lt: 미만)	String	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].condition.target	비교 대상 나이 유형 (low, high, median)	String	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].conditionIndex	조건식 인덱스 (0부터 시작)	Number	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].finalResult	해당 조건식의 최종 검증 결과 (true: 성공, false: 실패)	Boolean	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults	각 타겟 이미지와 기준 나이 조합별 비교 결과	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.idCardCustomMatch	신분증 이미지와 고정값 나이 비교 결과	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.idCardBirthDateMatch	신분증 이미지와 생년월일 나이 비교 결과	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.faceImageCustomMatch	셀피 이미지와 고정값 나이 비교 결과	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.faceImageBirthDateMatch	셀피 이미지와 생년월일 나이 비교 결과	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.*.result	개별 비교의 성공/실패 결과 (true: 성공, false: 실패, null: 없을 때)	Boolean	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.*.processed	해당 비교가 실행되었는지 여부 (true: 성공, false: 실패)	Boolean	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.*.statement	비교 연산의 구체적인 내용 (예: “36 gte 18”)	String	얼굴 나이 검증 정보
verification.faceAge[i].logicalOperators	조건식 간 논리 연산자 배열 (and, or)	Array	얼굴 나이 검증 정보
signals	얼굴에서 추출된 원시 데이터를 포함하는 객체	Object	얼굴 감지 정보
signals.faceAge	얼굴에서 추출된 나이 범위 정보 배열 (매 시도별 누적 기록)	Array	얼굴 감지 정보
signals.faceAge[i].ageRange	해당 시도에서 감지된 나이 범위	Object	얼굴 감지 정보
signals.faceAge[i].ageRange.low	감지된 최저 나이 추정값	Number	얼굴 감지 정보
signals.faceAge[i].ageRange.high	감지된 최고 나이 추정값	Number	얼굴 감지 정보
signals.faceAge[i].ageRange.median	감지된 중간 나이 추정값	Number	얼굴 감지 정보
signals.faceAge[i].source	나이 추정 소스 이미지 유형 (selfieImage, idImage)	String	얼굴 감지 정보
signals.startButtonClickTime	사용자가 시작 버튼을 클릭한 시각 (ISO 8601 형식)	String	카메라 프로세스 정보
signals.cameraProcessInfo	카메라 동작 데이터 배열	Array	카메라 프로세스 정보
signals.cameraProcessInfo[i].type	프로세스 타입 (예: idcard-front-capture, id-document-face-passive, 등)	String	카메라 프로세스 정보
signals.cameraProcessInfo[i].processStartTime	해당 프로세스가 시작된 시각 (ISO 8601 형식)	String	카메라 프로세스 정보
signals.cameraProcessInfo[i].processEndTime	해당 프로세스가 종료된 시각 (ISO 8601 형식)	String	카메라 프로세스 정보
signals.cameraProcessInfo[i].error	해당 프로세스 중 발생한 에러 (null이면 에러 없음)	String	카메라 프로세스 정보
updateHistory	마지막으로 제출 정보가 업데이트된 기록	Object	대시보드 정보
updateHistory.updateAdmin	마지막으로 제출 정보를 업데이트한 admin의 이메일	String	대시보드 정보
updateHistory.updateTime	마지막으로 제출 정보를 업데이트한 시각	String	대시보드 정보
kyc.retry	KYC 처리 중 재시도 조건을 일으킨 재시도 정보를 포함하는 배열	Array	KYC 재시도 정보
kyc.retry[i].type	재시도를 일으킨 단계 유형 (step1, step2)	String	KYC 재시도 정보
kyc.retry[i].retryCnt	해당 재시도 조건에 대한 재시도 횟수	Number	KYC 재시도 정보
kyc.retry[i].retryCode	발생한 특정 재시도 조건을 식별하는 코드	String	KYC 재시도 정보
kyc.retry[i].retryMessage	재시도 조건을 설명하고 권장 조치를 제공하는 상세 메시지	String	KYC 재시도 정보
aml	AML 스크리닝 결과를 포함하는 객체	Object	AML 스크리닝 정보
aml.raw_data	AML 스크리닝의 원시 데이터	Object	AML 스크리닝 정보
aml.risk_level_summary	리스크 수준 요약 (Not Screened, High, Medium, Low) Risk Level	Enum	AML 스크리닝 정보
aml.currentstatus	AML 스크리닝의 현재 상태 (Not Screened, Red Flag) AML Screening Status	Enum	AML 스크리닝 정보
aml.matches	AML 스크리닝의 상세 매칭 결과	Array	AML 스크리닝 정보
aml.matches[i].risk_level	레드 플래그 위험 수준 (HIGH, MEDIUM, LOW) AML Screening Info	Enum	AML 스크리닝 정보
aml.matches[i].argos_number	AML 보고서를 조회하기 위한 고유 ID	String	AML 스크리닝 정보
aml.matches[i].resource_id	AML 보고서를 조회하기 위한 리소스 고유 ID	String	AML 스크리닝 정보
aml.matches[i].score	AML 스크리닝 매칭 점수	Float	AML 스크리닝 정보
aml.matches[i].risk_icons	AML 스크리닝 위험 아이콘	Array	AML 스크리닝 정보
nextpageKey	추가 페이지를 호출할 때 필요한 키	Object	페이지 네비게이션 정보
nextpageKey.id	마지막으로 조회된 제출 ID	String	페이지 네비게이션 정보
nextpageKey.created_at	마지막으로 조회된 제출의 생성 시간	String	페이지 네비게이션 정보
bank_verification	계좌 인증 결과를 포함하는 객체	Object	계좌 인증 정보
bank_verification.result	계좌 인증 결과 (success, fail)	Enum	계좌 인증 정보
bank_verification.type	계좌 인증 유형 (occupancy(1원 인증), nameCheck)	Enum	계좌 인증 정보
bank_verification.bank_code	계좌 인증에 사용된 은행 코드	String	계좌 인증 정보
bank_verification.account_number	계좌 인증에 사용된 계좌 번호	String	계좌 인증 정보
bank_verification.retry_count	코드 전송 실패 횟수 (pre-step2)	Number	계좌 인증 정보
id_LivenessScore	ID 카드 생체 인증 점수 데이터를 포함하는 객체	Object	생체 인증 점수 정보
id_LivenessScore.Screen_play	Screen play 파이프라인의 생체 인증 점수	Float	생체 인증 점수 정보
id_LivenessScore.Paper_printed	Paper printed 파이프라인의 생체 인증 점수	Float	생체 인증 점수 정보
id_LivenessScore.Replace_portraits	Replace portraits 파이프라인의 생체 인증 점수	Float	생체 인증 점수 정보
Injection_action	Injection 프로세스 실행 내역을 포함하는 객체	Object	Injection 프로세스 정보
Injection_action.type	Injection 프로세스 유형	String	Injection 프로세스 정보
Injection_action.time	Injection 프로세스 유형별 최근 실행 시간	String	Injection 프로세스 정보
projection	해당 서브미션에 적용된 Projection 정보를 포함하는 객체	Object	Projection Info
projection.projectionId	해당 제출건에 적용된 Projection의 ID	String	Projection Info
projection.projectionName	해당 제출건에 적용된 Projection의 이름	String	Projection Info
tokenId	Private mode에서 제출 시 사용된 Token ID	String	제출 정보
pre_verification	pre_verification 객체 목록	object	pre_verification 정보
pre_verification.request_id	pre_verification의 요청 ID	String	pre_verification 정보
pre_verification.created_at	요청 타임스탬프	String	pre_verification 정보
pre_verification.ip_address	요청 IP 주소	String	pre_verification 정보
pre_verification.fraud_score	사기 점수	Number	pre_verification 정보
pre_verification.attempts_frequency	서브넷 시도 빈도: [0=‘FirstSeen’, 19=‘Rare’, 1029=‘Frequent’, 30+=‘VeryFrequent’]	String	pre_verification 정보
pre_verification.country_code	요청된 IP 주소의 국가 코드	String	pre_verification 정보
pre_verification.connection_type	연결 유형: [‘Residential’, ‘Corporate’, ‘Education’, ‘Mobile’, ‘DataCenter’]	String	pre_verification 정보
pre_verification.is_valid	pre_verification이 실패인지 통과인지의 상태	Boolean	pre_verification 정보

​

5-2-b. 응답 데이터 (Knowledge-based)

Field Name	Description	Data Type	Category
data	KYC 제출자 데이터	Object	KYC 제출자 정보
data.name	제출자의 이름	String	KYC 제출자 정보
data.gender	제출자의 성별 (male 또는 female)	Enum	KYC 제출자 정보
data.nationality	ISO alpha-3 형식의 국가 코드	String	KYC 제출자 정보
data.date_of_birth	제출자의 생년월일 (YYYY-MM-DD 형식)	Date	KYC 제출자 정보
data.address_formatted	변환된 상세 주소	String	KYC 제출자 정보
data.address_detail	사용자가 입력한 상세 주소	String	KYC 제출자 정보
data.ssnNumber	소셜 시큐리티 넘버	String	KYC Applicant Info
data.phoneNumber	전화번호	String	KYC Applicant Info
data.cf1	사용자 정의 필드 #1	String	KYC 제출자 정보
data.cf2	사용자 정의 필드 #2	String	KYC 제출자 정보
data.cf3	사용자 정의 필드 #3	String	KYC 제출자 정보
email	제출과 연관된 이메일 주소	String	KYC 제출자 정보
reviewer	검수 유형: system은 AI 시스템 검수, agent는 사람 검수를 나타냄	Enum	KYC 검수 정보
submission_id	각 제출 건에 부여된 고유 식별자	String	제출 정보
duplicated_information	이름, 생년월일, 성별, 국적을 기준으로 중복 확인용 식별자가 생성됩니다. (*네 가지 기준이 모두 제공되면 항상 생성됩니다.)	String	제출 정보
created_at	제출된 날짜와 시간 (UTC+0)	String	제출 정보
kyc_result_at	KYC 결과가 최종적으로 결정된 날짜와 시간	String	제출 정보
updated_at	마지막으로 제출 정보가 업데이트된 날짜와 시간	String	제출 정보
pending_at	KYC가 보류(Pending) 상태로 표시된 날짜와 시간	String	제출 정보
userid	제출 생성 시 선택적으로 추가된 파라미터	String	제출 정보
additional_list	대시보드에서 설정된 추가 양식에 대해 사용자가 입력한 데이터	Array	추가 양식 정보
additional_list.answer	각 추가 양식 필드의 이름	String	추가 양식 정보
additional_list.inputValue	각 필드에 대한 사용자 입력 값	String	추가 양식 정보
additional_list.blockType	각 추가 양식 필드의 데이터 타입	String	추가 양식 정보
verification	얼굴 기반 나이 검증 결과를 포함하는 객체	Object	얼굴 나이 검증 정보
verification.faceAge	얼굴 기반 나이 검증의 전체 결과 배열 (매 시도별 누적 기록)	Array	얼굴 나이 검증 정보
verification.faceAge[i].usedValues	검증에 사용된 나이 값들	Object	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieLow	LOW/HIGH 확장 설정 적용 전 셀피 이미지의 최저 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieHigh	LOW/HIGH 확장 설정 적용 전 셀피 이미지의 최고 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieMedian	LOW/HIGH 확장 설정 적용 전 셀피 이미지의 중간 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdLow	LOW/HIGH 확장 설정 적용 전 신분증 이미지의 최저 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdHigh	LOW/HIGH 확장 설정 적용 전 신분증 이미지의 최고 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdMedian	LOW/HIGH 확장 설정 적용 전 신분증 이미지의 중간 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieLow	LOW/HIGH 확장 설정 적용 후 셀피 이미지의 최저 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieHigh	LOW/HIGH 확장 설정 적용 후 셀피 이미지의 최고 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieMedian	LOW/HIGH 확장 설정 적용 후 셀피 이미지의 중간 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idLow	LOW/HIGH 확장 설정 적용 후 신분증 이미지의 최저 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idHigh	LOW/HIGH 확장 설정 적용 후 신분증 이미지의 최고 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idMedian	LOW/HIGH 확장 설정 적용 후 신분증 이미지의 중간 나이 추정값	Number	얼굴 나이 검증 정보
verification.faceAge[i].usedValues.birthDateAge	사용자 입력 생년월일로 계산한 만 나이	Number	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults	각 조건식별 검증 결과 배열	Array	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].condition	조건식 설정 정보	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].condition.comparisonOperator	비교 연산자 (gte: 이상, gt: 초과, lte: 이하, lt: 미만)	String	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].condition.target	비교 대상 나이 유형 (low, high, median)	String	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].conditionIndex	조건식 인덱스 (0부터 시작)	Number	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].finalResult	해당 조건식의 최종 검증 결과 (true: 성공, false: 실패)	Boolean	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults	각 타겟 이미지와 기준 나이 조합별 비교 결과	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.idCardCustomMatch	신분증 이미지와 고정값 나이 비교 결과	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.idCardBirthDateMatch	신분증 이미지와 생년월일 나이 비교 결과	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.faceImageCustomMatch	셀피 이미지와 고정값 나이 비교 결과	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.faceImageBirthDateMatch	셀피 이미지와 생년월일 나이 비교 결과	Object	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.*.result	개별 비교의 성공/실패 결과 (true: 성공, false: 실패, null: 없을 때)	Boolean	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.*.processed	해당 비교가 실행되었는지 여부 (true: 성공, false: 실패)	Boolean	얼굴 나이 검증 정보
verification.faceAge[i].conditionResults[j].matchResults.*.statement	비교 연산의 구체적인 내용 (예: “36 gte 18”)	String	얼굴 나이 검증 정보
verification.faceAge[i].logicalOperators	조건식 간 논리 연산자 배열 (and, or)	Array	얼굴 나이 검증 정보
signals	얼굴에서 추출된 원시 데이터를 포함하는 객체	Object	얼굴 감지 정보
signals.faceAge	얼굴에서 추출된 나이 범위 정보 배열 (매 시도별 누적 기록)	Array	얼굴 감지 정보
signals.faceAge[i].ageRange	해당 시도에서 감지된 나이 범위	Object	얼굴 감지 정보
signals.faceAge[i].ageRange.low	감지된 최저 나이 추정값	Number	얼굴 감지 정보
signals.faceAge[i].ageRange.high	감지된 최고 나이 추정값	Number	얼굴 감지 정보
signals.faceAge[i].ageRange.median	감지된 중간 나이 추정값	Number	얼굴 감지 정보
signals.faceAge[i].source	나이 추정 소스 이미지 유형 (selfieImage, idImage)	String	얼굴 감지 정보
signals.startButtonClickTime	사용자가 시작 버튼을 클릭한 시각 (ISO 8601 형식)	String	카메라 프로세스 정보
signals.cameraProcessInfo	카메라 동작 데이터 배열	Array	카메라 프로세스 정보
signals.cameraProcessInfo[i].type	프로세스 타입 (예: knowledge-face-passive, knowledge-face-active, 등)	String	카메라 프로세스 정보
signals.cameraProcessInfo[i].processStartTime	해당 프로세스가 시작된 시각 (ISO 8601 형식)	String	카메라 프로세스 정보
signals.cameraProcessInfo[i].processEndTime	해당 프로세스가 종료된 시각 (ISO 8601 형식)	String	카메라 프로세스 정보
signals.cameraProcessInfo[i].error	해당 프로세스 중 발생한 에러 (null이면 에러 없음)	String	카메라 프로세스 정보
kyc	KYC 결과를 포함하는 객체 KYC 상태	Object	KYC 결과 정보
kyc.result	KYC 프로세스의 상태	Enum	KYC 결과 정보
kyc.comment	KYC 거절 사유 [거절 코드 및 사유]/ko/idcheck/api-reference/api-reference-guide/reject-codes-and-comments)	String	KYC 결과 정보
kyc.commentCode	KYC 거절 사유를 나타내는 코드 거절 코드 및 사유	String	KYC 결과 정보
kyc.attempts[i].attemptCnt	실패 후 재시도한 횟수	Number	KYC 시도 정보
kyc.attempts[i].errorCode	얼굴 인식, 비교 확인 중 발생한 오류 코드	String	KYC 시도 정보
kyc.attempts[i].errorMsg	얼굴 인식, 비교 확인 중 발생한 오류 메시지	String	KYC 시도 정보
kyc.attempts[i].step1Time1st	step1 첫 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].step1Time2nd	step1 두 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].step1Time3rd	step1 세 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].step2Time1st	step2 첫 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].step2Time2nd	step2 두 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].step2Time3rd	step2 세 번째 호출 시간	String	KYC 시도 정보
kyc.attempts[i].retryMsg	얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 메시지	String	KYC 시도 정보
kyc.attempts[i].retryCode	얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 코드	String	KYC 시도 정보
kyc.attempts[i].faceSimilarityScore	얼굴 비교 유사도 점수	Float	KYC 시도 정보
kyc.attempts[i].selfieImage	제출된 셀피 이미지의 URL	String	KYC 시도 정보
kyc.attempts[i].livenessScore	시도의 생체 인증 점수	Float	KYC 시도 정보
kyc.attempts[i].liveness	생체 인증 점수의 상세 데이터 (score, probability, quality 포함)	Object	KYC 시도 정보
kyc.attempts[i].liveness.score	생체 인증의 전체 점수	Float	KYC 시도 정보
kyc.attempts[i].liveness.probability	생체 인증의 확률 값	Float	KYC 시도 정보
kyc.attempts[i].liveness.quality	생체 인증의 품질 점수	Float	KYC 시도 정보
kyc.attempts[i].detectFace	얼굴 감지 결과를 포함하는 배열 (AWS Rekognition DetectFaces API 응답)	Array	얼굴 감지 정보
kyc.attempts[i].detectFace.AgeRange	감지된 얼굴의 나이 범위 정보	Object	얼굴 감지 정보
kyc.attempts[i].detectFace.AgeRange.High	감지된 얼굴의 최고 나이 추정값	Number	얼굴 감지 정보
kyc.attempts[i].detectFace.AgeRange.Low	감지된 얼굴의 최저 나이 추정값	Number	얼굴 감지 정보
kyc.attempts[i].detectFace.Gender.Confidence	성별 판정의 신뢰도 (0~100)	Float	얼굴 감지 정보
kyc.attempts[i].detectFace.Gender.Value	감지된 성별 (Male, Female)	String	얼굴 감지 정보
verification	얼굴 기반 나이 검증 결과를 포함하는 객체	Object	얼굴 나이 검증 정보
aml	AML 스크리닝 결과를 포함하는 객체	Object	AML 스크리닝 정보
aml.raw_data	AML 스크리닝의 원시 데이터	Object	AML 스크리닝 정보
aml.risk_level_summary	리스크 수준 요약 (Not Screened, High, Medium, Low) Risk Level	Enum	AML 스크리닝 정보
aml.currentstatus	AML 스크리닝의 현재 상태 (Not Screened, Red Flag) AML Screening Status	Enum	AML 스크리닝 정보
aml.matches	AML 스크리닝의 상세 매칭 결과	Array	AML 스크리닝 정보
aml.matches[i].risk_level	레드 플래그 위험 수준 (HIGH, MEDIUM, LOW) AML Screening Info	Enum	AML 스크리닝 정보
aml.matches[i].argos_number	AML 보고서를 조회하기 위한 고유 ID	String	AML 스크리닝 정보
aml.matches[i].resource_id	AML 보고서를 조회하기 위한 리소스 고유 ID	String	AML 스크리닝 정보
aml.matches[i].score	AML 스크리닝 매칭 점수	Float	AML 스크리닝 정보
aml.matches[i].risk_icons	AML 스크리닝 위험 아이콘	Array	AML 스크리닝 정보
nextpageKey	추가 페이지를 호출할 때 필요한 키	Object	페이지 네비게이션 정보
nextpageKey.id	마지막으로 조회된 제출 ID	String	페이지 네비게이션 정보
nextpageKey.created_at	마지막으로 조회된 제출의 생성 시간	String	페이지 네비게이션 정보
projection	해당 서브미션에 적용된 Projection 정보를 포함하는 객체	Object	Projection Info
projection.projectionId	해당 제출건에 적용된 Projection의 ID	String	Projection Info
projection.projectionName	해당 제출건에 적용된 Projection의 이름	String	Projection Info
tokenId	Private mode에서 제출 시 사용된 Token ID	String	제출 정보
pre_verification	pre_verification 객체 목록	object	pre_verification 정보
pre_verification.request_id	pre_verification의 요청 ID	String	pre_verification 정보
pre_verification.created_at	요청 타임스탬프	String	pre_verification 정보
pre_verification.ip_address	요청 IP 주소	String	pre_verification 정보
pre_verification.fraud_score	사기 점수	Number	pre_verification 정보
pre_verification.attempts_frequency	서브넷 시도 빈도: [0=‘FirstSeen’, 19=‘Rare’, 1029=‘Frequent’, 30+=‘VeryFrequent’]	String	pre_verification 정보
pre_verification.country_code	요청된 IP 주소의 국가 코드	String	pre_verification 정보
pre_verification.connection_type	연결 유형: [‘Residential’, ‘Corporate’, ‘Education’, ‘Mobile’, ‘DataCenter’]	String	pre_verification 정보
pre_verification.is_valid	pre_verification이 실패인지 통과인지의 상태	Boolean	pre_verification 정보

​

5-2-c. 카메라 프로세스 타입 상세

프로세스 과정에서 생성된 부가 데이터는 signals 하위에서 응답합니다. signals.cameraProcessInfo 배열의 type 필드는 각 프로세스 단계에서 사용자가 어떤 방식으로 이미지를 제출했는지를 나타냅니다.

1. 신분증 처리 프로세스

신분증 이미지를 획득하는 방식을 정의하는 프로세스 타입입니다.

​

1.1 신분증 앞면 (ProcessIdCardFront)

신분증 앞면 이미지를 획득하는 방식을 정의합니다.

타입	설명
idcard-front-upload	파일 업로드 방식 - 사용자가 기기에 저장된 신분증 앞면 이미지 파일을 직접 선택하여 업로드
idcard-front-capture	캡처 방식 - 카메라를 통해 실시간으로 신분증 앞면을 촬영하며, 사용자가 직접 촬영 타이밍을 제어
idcard-front-autocapture	자동 캡처 방식 - 카메라를 통해 신분증을 인식하면 자동으로 촬영하며, 신분증 위치, 각도, 초점 등의 조건이 충족되면 자동 촬영

​

1.2 신분증 뒷면 (ProcessIdCardBack)

신분증 뒷면 이미지를 획득하는 방식을 정의합니다.

타입	설명
idcard-back-upload	파일 업로드 방식 - 사용자가 기기에 저장된 신분증 뒷면 이미지 파일을 직접 선택하여 업로드
idcard-back-capture	캡처 방식 - 카메라를 통해 실시간으로 신분증 뒷면을 촬영하며, 사용자가 직접 촬영 타이밍을 제어
idcard-back-autocapture	자동 캡처 방식 - 카메라를 통해 신분증을 인식하면 자동으로 촬영하며, 신분증 위치, 각도, 초점 등의 조건이 충족되면 자동 촬영

2. 얼굴 인증 프로세스

얼굴 이미지를 획득하여 인증하는 방식을 정의하는 프로세스 타입입니다.

​

2.1 신분증 기반 얼굴 인증 (IdDocumentFace)

신분증에 등록된 얼굴과 비교하기 위한 얼굴 이미지를 획득하는 방식을 정의합니다.

타입	설명
id-document-face-passive	패시브 방식 - 카메라를 통해 자연스러운 상태의 얼굴을 촬영하며, 별도의 동작이나 표정 변화 없이 정면 얼굴만 촬영
id-document-face-active	액티브 방식 - 카메라를 통해 특정 동작을 수행하는 얼굴을 촬영

​

2.2 Knowledge 얼굴 인증 (KnowledgeFace)

기존에 등록된 얼굴 정보와 비교하기 위한 얼굴 이미지를 획득하는 방식을 정의합니다.

타입	설명
knowledge-face-passive	패시브 방식 - 카메라를 통해 자연스러운 상태의 얼굴을 촬영
knowledge-face-active	액티브 방식 - 카메라를 통해 특정 동작을 수행하는 얼굴을 촬영

signals.cameraProcessInfo 배열에는 사용자가 제출 과정에서 거친 모든 프로세스 단계가 순차적으로 기록됩니다. 각 프로세스의 시작 시간, 종료 시간, 에러 정보를 통해 사용자의 제출 과정을 추적할 수 있습니다.

​

5-3. 오류 코드

에러 코드	메시지	설명
invalid_payload	Invalid payload	요청 본문을 파싱할 수 없음
missing_data	Required input data is missing	필수 필드가 누락됨
invalid_project	Invalid project	프로젝트 ID가 유효하지 않음
invalid_admin	Invalid admin	관리자 계정에 이 프로젝트에 대한 권한이 없음
invalid_parameter	invalid parameter: {parameter}	예상치 못한 매개변수가 제출됨
invalid_format	invalid format: ${parameter}	매개변수가 예상 형식과 일치하지 않음
processing_error	Failed to complete migration	처리 중 알 수 없는 오류 발생

​

6. 암호화 옵션

사전 요구 사항 : 안전한 암호화 옵션을 활성화해야 합니다. 암호화 적용 전에 가이드를 먼저 확인해주세요.

보안 강화를 위해 요청 본문을 암호화할 수 있습니다. 암호화를 사용할 때: 전체 요청 본문 객체를 암호화합니다. 암호화된 문자열을 body 매개변수로 전송합니다.

​

6-1. 암호화된 요청 예시

{
  "start_date": "2025-01-01",
  "end_date": "2025-03-01"
}

안전한 데이터 전송 옵션이 활성화 된 프로젝트에서 줄 수 있는 옵션은 다음과 같습니다.

encrypt-available-params.json

body : encrypt({
		email : 'string',
		start_date : 'string',
		end_date : 'string',
		submission_id: 'string'
	})

위 값을 AES-256-ECB 로 암호화 한뒤 URI encode 를 합니다.

N34SNtWaavEfgtg1g%2Bo%2B9JhQ9rp9dGUbyFNxAsHKKGH24aVQTRXYfNpFDHIGJU6Wo0RVpOupAubiDvFDuFyTkw%3D%3D

그리고 Query String 에서data 파라메터로 위 암호화된 값을 입력 후 호출합니다.

curl -X GET "https://rest-api.argosidentity.com/v3/submission?data=N34SNtWaavEfgtg1g%2Bo%2B9JhQ9rp9dGUbyFNxAsHKKGH24aVQTRXYfNpFDHIGJU6Wo0RVpOupAubiDvFDuFyTkw%3D%3D" \
--header 'Content-Type: application/json' \
--header 'x-api-key: change_your_api_key'

​

6-2. 암호화된 응답

응답에는 isEncrypted 플래그와 암호화된 데이터가 포함됩니다:

result.json

response : {
   body : {
    "data": "encrypted-string",
    "isEncrypted": true
   }
}