본 메소드는 다수의 목록을 가져옵니다. 하지만, 단일 건에서만 보이는 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. 요청 예시

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

5. 응답

5-1. 성공 응답

{
    "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": "{********}"
            },
            "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": 30,
                            "median": 27,
                            "low": 24
                        },
                        "source": "selfieImage"
                    },
                    {
                        "ageRange": {
                            "high": 22,
                            "median": 19,
                            "low": 16
                        },
                        "source": "idImage"
                    }
                ]
            },
            "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)

필드명설명데이터 타입카테고리
dataKYC 제출자 데이터ObjectKYC 제출자 정보
data.age_group제출자의 연령대: minor, early-teen, teen, adultStringKYC 제출자 정보
data.first_name제출자의 First NameStringKYC 제출자 정보
data.last_name제출자의 Last NameStringKYC 제출자 정보
data.full_name제출자의 Full NameStringKYC 제출자 정보
data.gender제출자의 성별 (male 또는 female)EnumKYC 제출자 정보
data.nationalityISO alpha-3 형식의 국가 코드StringKYC 제출자 정보
data.date_of_birth제출자의 생년월일 (YYYY-MM-DD 형식)DateKYC 제출자 정보
data.ip_addressIPv4 형식의 IP 주소StringKYC 제출자 정보
data.idType사용된 신분증 유형EnumKYC 제출자 정보
data.idcard_issuingCountry신분증 발급 국가의 ISO alpha-3 형식 코드 ISO Alpha-3 국가 코드StringKYC 제출자 정보
data.idcard_issueDate신분증 발급일 (YYYY-MM-DD 형식)StringKYC 제출자 정보
data.idcard_expireDate신분증 만료일 (YYYY-MM-DD 형식)StringKYC 제출자 정보
data.identityNumber주민등록번호StringKYC 제출자 정보
data.documentNumber신분증 번호StringKYC 제출자 정보
data.address_city도시StringKYC 제출자 정보
data.address_country국가StringKYC 제출자 정보
data.address_stateStringKYC 제출자 정보
data.address_street도로StringKYC 제출자 정보
data.address_zipcode우편번호StringKYC 제출자 정보
data.address_globalCode글로벌 주소 코드 (예: 8Q98HXPG+MP)StringKYC 제출자 정보
data.address_compoundCode복합 주소 코드 (예: HXPG+MP 서울, 대한민국)StringKYC 제출자 정보
data.address_formatted변환된 상세 주소StringKYC 제출자 정보
data.address_input사용자가 입력한 주소StringKYC 제출자 정보
data.address_detail사용자가 입력한 상세 주소StringKYC 제출자 정보
data.cf1사용자 정의 필드 #1StringKYC 제출자 정보
data.cf2사용자 정의 필드 #2StringKYC 제출자 정보
data.cf3사용자 정의 필드 #3StringKYC 제출자 정보
imageArgosServer에서 ID 문서 및 셀피에 대한 이미지 링크를 포함하는 이미지 객체; GET/Image를 사용해서만 이미지를 다운로드할 수 있음Object제출 정보
image.idImageArgosServer의 ID 문서 이미지 링크; 이미지를 다운로드할 수 없음String제출 정보
image.idBackImageArgosServer의 ID 문서 뒷면 이미지 링크; 이미지를 다운로드할 수 없음String제출 정보
image.selfieImageArgosServer의 셀피 이미지 링크; 이미지를 다운로드할 수 없음String제출 정보
image.addressImageArgosServer의 주소 문서 이미지 링크; 이미지를 다운로드할 수 없음String제출 정보
memo대시보드 제출 메모 객체Object대시보드 정보
memo.text대시보드 제출 메모 내용string대시보드 정보
memo.updated_at대시보드 제출 메모 업데이트 시간string대시보드 정보
duplicated_users중복된 PII를 가진 것으로 발견된 제출 ID 목록ArrayKYC 제출자 정보
duplicated_selfie_users중복된 얼굴을 가진 것으로 발견된 제출 ID 목록ArrayKYC 제출자 정보
OCR_raw.rotate.valueOCR 이 인식된 각도StringKYC 제출자 정보
OCR_raw.{item}.value인식된 OCR 의 값StringKYC 제출자 정보
OCR_raw.{item}.score인식률 점수 (0~100)IntKYC 제출자 정보
OCR_raw.{item}.accepted인식 성공 여부BoolKYC 제출자 정보
OCR_raw.{item}.coordinates인식된 OCR 의 벡터 데이터ObjectKYC 제출자 정보
ocr.birthDateOCR 인식 제출자의 생년월일 (YYYY-MM-DD 형식)DateKYC 제출자 정보
ocr.issueDateOCR 인식 발급일자DateKYC 제출자 정보
ocr.expireDateOCR 인식 만료일자DateKYC 제출자 정보
ocr.firstNameOCR 인식 제출자의 First NameStringKYC 제출자 정보
ocr.lastNameOCR 인식 제출자의 Last NameStringKYC 제출자 정보
ocr.fullNameOCR 인식 제출자의 Full NameStringKYC 제출자 정보
ocr.genderOCR 인식 제출자의 성별 ( male 또는 female )EnumKYC 제출자 정보
ocr.numberOCR 인식 문서번호 (Document Number)StringKYC 제출자 정보
ocr.licenseNumberOCR 인식 면허번호StringKYC 제출자 정보
ocr.identityNumberOCR 인식 주민등록번호StringKYC 제출자 정보
ocr.curpNumberOCR 인식 MEX.ID 의 Curp NumberStringKYC 제출자 정보
ocr.nationalityOCR 인식 ISO alpha-3 형식의 국가 코드StringKYC 제출자 정보
ocr.serialNumberOCR 인식 일련번호StringKYC 제출자 정보
review.birthDate제출자의 생년월일 (YYYY-MM-DD 형식)DateKYC 제출자 정보
review.issueDate발급일자DateKYC 제출자 정보
review.expireDate만료일자DateKYC 제출자 정보
review.fullName제출자의 Full NameStringKYC 제출자 정보
review.gender제출자의 성별 ( male 또는 female )EnumKYC 제출자 정보
review.nationalityISO alpha-3 형식의 국가 코드StringKYC 제출자 정보
review.documentNumber문서번호StringKYC 제출자 정보
review.licenseNumber면허번호StringKYC 제출자 정보
review.identityNumber주민등록번호StringKYC 제출자 정보
review.curpNumberMEX.ID 의 Curp NumberStringKYC Applicant Info
email제출과 연관된 이메일 주소StringKYC 제출자 정보
reviewer검수 유형: system은 AI 시스템 검수, agent는 사람 검수를 나타냄EnumKYC 검수 정보
Injection_action.attemptStatusInjection 시도 결과StringKYC injection 정보
Injection_action.createTimeInjection 생성일시 (UTC+0) *순서: 최신이 최상단, 이후 오래된 순서 정렬StringKYC injection 정보
Injection_action.userInput.address유저가 입력한 주소 정보ObjectKYC injection 정보
Injection_action.option.distanceChecksInjection 거리 측정에 사용된 서비스와 거리 정보ObjectKYC injection 정보
Injection_action.option.ipRiskIP 위험 평가 카테고리 및 차단 시간 정보ObjectKYC injection 정보
Injection_action.option.ipVerificationInjection 진행 시 확인된 IP 정보ObjectKYC injection 정보
submission_id각 제출 건에 부여된 고유 식별자String제출 정보
recognition_score신분증 인식 점수Float제출 정보
argos_scoreARGOS 시스템의 종합 평가 점수Float제출 정보
duplicated_information이름, 생년월일, 성별, 국적을 기준으로 중복 확인용 식별자가 생성됩니다. (*네 가지 기준이 모두 제공되면 항상 생성됩니다.)String제출 정보
applicant_id중복 제출된 사용자에 부여된 식별자String제출 정보
created_at제출된 날짜와 시간 (UTC+0)String제출 정보
kyc_result_atKYC 결과가 최종적으로 결정된 날짜와 시간String제출 정보
updated_at마지막으로 제출 정보가 업데이트된 날짜와 시간String제출 정보
pending_atKYC가 보류(Pending) 상태로 표시된 날짜와 시간String제출 정보
userid제출 생성 시 선택적으로 추가된 파라미터String제출 정보
additional_list대시보드에서 설정된 추가 양식에 대해 사용자가 입력한 데이터Array추가 양식 정보
additional_list.answer각 추가 양식 필드의 이름String추가 양식 정보
additional_list.inputValue각 필드에 대한 사용자 입력 값String추가 양식 정보
additional_list.blockType각 추가 양식 필드의 데이터 타입String추가 양식 정보
kycKYC 결과를 포함하는 객체 KYC 상태ObjectKYC 결과 정보
kyc.resultKYC 프로세스의 상태EnumKYC 결과 정보
kyc.commentKYC 거절 사유 거절 코드 및 사유StringKYC 결과 정보
kyc.commentCodeKYC 거절 사유를 나타내는 코드 거절 코드 및 사유StringKYC 결과 정보
kyc.attempts[i].attemptCnt실패 후 재시도한 횟수NumberKYC 시도 정보
kyc.attempts[i].idBarcodeResult미국, 캐나다, 멕시코 신분증의 바코드 검증 결과StringKYC 시도 정보
kyc.attempts[i].verificationResult신분증 진위 확인 결과 (success, fail)EnumKYC 시도 정보
kyc.attempts[i].verification신분증 진위 확인 결과의 상세 데이터ObjectKYC 시도 정보
kyc.attempts[i].verificationParams신분증 진위 확인 실행 시 필요한 매개변수ObjectKYC 시도 정보
kyc.attempts[i].errorCode얼굴 인식, 비교, 신분증 진위 확인 중 발생한 오류 코드StringKYC 시도 정보
kyc.attempts[i].errorMsg얼굴 인식, 비교, 신분증 진위 확인 중 발생한 오류 메시지StringKYC 시도 정보
kyc.attempts[i].step1Time1ststep1 첫 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].step1Time2ndstep1 두 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].step1Time3rdstep1 세 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].step2Time1ststep2 첫 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].step2Time2ndstep2 두 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].step2Time3rdstep2 세 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].retryMsg얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 메시지StringKYC 시도 정보
kyc.attempts[i].retryCode얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 코드StringKYC 시도 정보
kyc.attempts[i].faceSimilarityScore얼굴 비교 유사도 점수FloatKYC 시도 정보
kyc.attempts[i].selfieImage제출된 셀피 이미지의 URLStringKYC 시도 정보
kyc.attempts[i].livenessScore시도의 생체 인증 점수FloatKYC 시도 정보
kyc.attempts[i].liveness생체 인증 점수의 상세 데이터 (score, probability, quality 포함)ObjectKYC 시도 정보
kyc.attempts[i].liveness.score생체 인증의 전체 점수FloatKYC 시도 정보
kyc.attempts[i].liveness.probability생체 인증의 확률 값FloatKYC 시도 정보
kyc.attempts[i].liveness.quality생체 인증의 품질 점수FloatKYC 시도 정보
verification얼굴 기반 나이 검증 결과를 포함하는 객체Object얼굴 나이 검증 정보
verification.faceAge얼굴 기반 나이 검증의 전체 결과 배열 (매 시도별 누적 기록)Array얼굴 나이 검증 정보
verification.faceAge[i].usedValues검증에 사용된 나이 값들Object얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieLowLOW/HIGH 확장 설정 적용 전 셀피 이미지의 최저 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieHighLOW/HIGH 확장 설정 적용 전 셀피 이미지의 최고 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieMedianLOW/HIGH 확장 설정 적용 전 셀피 이미지의 중간 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdLowLOW/HIGH 확장 설정 적용 전 신분증 이미지의 최저 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdHighLOW/HIGH 확장 설정 적용 전 신분증 이미지의 최고 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdMedianLOW/HIGH 확장 설정 적용 전 신분증 이미지의 중간 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieLowLOW/HIGH 확장 설정 적용 후 셀피 이미지의 최저 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieHighLOW/HIGH 확장 설정 적용 후 셀피 이미지의 최고 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieMedianLOW/HIGH 확장 설정 적용 후 셀피 이미지의 중간 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idLowLOW/HIGH 확장 설정 적용 후 신분증 이미지의 최저 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idHighLOW/HIGH 확장 설정 적용 후 신분증 이미지의 최고 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idMedianLOW/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얼굴 감지 정보
kyc.retryKYC 처리 중 재시도 조건을 일으킨 재시도 정보를 포함하는 배열ArrayKYC 재시도 정보
kyc.retry[i].type재시도를 일으킨 단계 유형 (step1, step2)StringKYC 재시도 정보
kyc.retry[i].retryCnt해당 재시도 조건에 대한 재시도 횟수NumberKYC 재시도 정보
kyc.retry[i].retryCode발생한 특정 재시도 조건을 식별하는 코드StringKYC 재시도 정보
kyc.retry[i].retryMessage재시도 조건을 설명하고 권장 조치를 제공하는 상세 메시지StringKYC 재시도 정보
amlAML 스크리닝 결과를 포함하는 객체ObjectAML 스크리닝 정보
aml.raw_dataAML 스크리닝의 원시 데이터ObjectAML 스크리닝 정보
aml.risk_level_summary리스크 수준 요약 (Not Screened, High, Medium, Low) Risk LevelEnumAML 스크리닝 정보
aml.currentstatusAML 스크리닝의 현재 상태 (Not Screened, Red Flag) AML Screening StatusEnumAML 스크리닝 정보
aml.matchesAML 스크리닝의 상세 매칭 결과ArrayAML 스크리닝 정보
aml.matches[i].risk_level레드 플래그 위험 수준 (HIGH, MEDIUM, LOW) AML Screening InfoEnumAML 스크리닝 정보
aml.matches[i].argos_numberAML 보고서를 조회하기 위한 고유 IDStringAML 스크리닝 정보
aml.matches[i].resource_idAML 보고서를 조회하기 위한 리소스 고유 IDStringAML 스크리닝 정보
aml.matches[i].scoreAML 스크리닝 매칭 점수FloatAML 스크리닝 정보
aml.matches[i].risk_iconsAML 스크리닝 위험 아이콘ArrayAML 스크리닝 정보
nextpageKey추가 페이지를 호출할 때 필요한 키Object페이지 네비게이션 정보
nextpageKey.id마지막으로 조회된 제출 IDString페이지 네비게이션 정보
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_LivenessScoreID 카드 생체 인증 점수 데이터를 포함하는 객체Object생체 인증 점수 정보
id_LivenessScore.Screen_playScreen play 파이프라인의 생체 인증 점수Float생체 인증 점수 정보
id_LivenessScore.Paper_printedPaper printed 파이프라인의 생체 인증 점수Float생체 인증 점수 정보
id_LivenessScore.Replace_portraitsReplace portraits 파이프라인의 생체 인증 점수Float생체 인증 점수 정보
Injection_actionInjection 프로세스 실행 내역을 포함하는 객체ObjectInjection 프로세스 정보
Injection_action.typeInjection 프로세스 유형StringInjection 프로세스 정보
Injection_action.timeInjection 프로세스 유형별 최근 실행 시간StringInjection 프로세스 정보
projection해당 서브미션에 적용된 Projection 정보를 포함하는 객체ObjectProjection Info
projection.projectionId해당 제출건에 적용된 Projection의 IDStringProjection Info
projection.projectionName해당 제출건에 적용된 Projection의 이름StringProjection Info
tokenIdPrivate mode에서 제출 시 사용된 Token IDString제출 정보
pre_verificationpre_verification 객체 목록objectpre_verification 정보
pre_verification.request_idpre_verification의 요청 IDStringpre_verification 정보
pre_verification.created_at요청 타임스탬프Stringpre_verification 정보
pre_verification.ip_address요청 IP 주소Stringpre_verification 정보
pre_verification.fraud_score사기 점수Numberpre_verification 정보
pre_verification.attempts_frequency서브넷 시도 빈도: [0=‘FirstSeen’, 19=‘Rare’, 1029=‘Frequent’, 30+=‘VeryFrequent’]Stringpre_verification 정보
pre_verification.country_code요청된 IP 주소의 국가 코드Stringpre_verification 정보
pre_verification.connection_type연결 유형: [‘Residential’, ‘Corporate’, ‘Education’, ‘Mobile’, ‘DataCenter’]Stringpre_verification 정보
pre_verification.is_validpre_verification이 실패인지 통과인지의 상태Booleanpre_verification 정보

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

Field NameDescriptionData TypeCategory
dataKYC 제출자 데이터ObjectKYC 제출자 정보
data.name제출자의 이름StringKYC 제출자 정보
data.gender제출자의 성별 (male 또는 female)EnumKYC 제출자 정보
data.nationalityISO alpha-3 형식의 국가 코드StringKYC 제출자 정보
data.date_of_birth제출자의 생년월일 (YYYY-MM-DD 형식)DateKYC 제출자 정보
data.address_formatted변환된 상세 주소StringKYC 제출자 정보
data.address_detail사용자가 입력한 상세 주소StringKYC 제출자 정보
data.ssnNumber소셜 시큐리티 넘버StringKYC Applicant Info
data.phoneNumber전화번호StringKYC Applicant Info
data.cf1사용자 정의 필드 #1StringKYC 제출자 정보
data.cf2사용자 정의 필드 #2StringKYC 제출자 정보
data.cf3사용자 정의 필드 #3StringKYC 제출자 정보
email제출과 연관된 이메일 주소StringKYC 제출자 정보
reviewer검수 유형: system은 AI 시스템 검수, agent는 사람 검수를 나타냄EnumKYC 검수 정보
submission_id각 제출 건에 부여된 고유 식별자String제출 정보
duplicated_information이름, 생년월일, 성별, 국적을 기준으로 중복 확인용 식별자가 생성됩니다. (*네 가지 기준이 모두 제공되면 항상 생성됩니다.)String제출 정보
created_at제출된 날짜와 시간 (UTC+0)String제출 정보
kyc_result_atKYC 결과가 최종적으로 결정된 날짜와 시간String제출 정보
updated_at마지막으로 제출 정보가 업데이트된 날짜와 시간String제출 정보
pending_atKYC가 보류(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.originalSelfieLowLOW/HIGH 확장 설정 적용 전 셀피 이미지의 최저 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieHighLOW/HIGH 확장 설정 적용 전 셀피 이미지의 최고 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalSelfieMedianLOW/HIGH 확장 설정 적용 전 셀피 이미지의 중간 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdLowLOW/HIGH 확장 설정 적용 전 신분증 이미지의 최저 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdHighLOW/HIGH 확장 설정 적용 전 신분증 이미지의 최고 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.originalIdMedianLOW/HIGH 확장 설정 적용 전 신분증 이미지의 중간 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieLowLOW/HIGH 확장 설정 적용 후 셀피 이미지의 최저 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieHighLOW/HIGH 확장 설정 적용 후 셀피 이미지의 최고 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.selfieMedianLOW/HIGH 확장 설정 적용 후 셀피 이미지의 중간 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idLowLOW/HIGH 확장 설정 적용 후 신분증 이미지의 최저 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idHighLOW/HIGH 확장 설정 적용 후 신분증 이미지의 최고 나이 추정값Number얼굴 나이 검증 정보
verification.faceAge[i].usedValues.idMedianLOW/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얼굴 감지 정보
kycKYC 결과를 포함하는 객체 KYC 상태ObjectKYC 결과 정보
kyc.resultKYC 프로세스의 상태EnumKYC 결과 정보
kyc.commentKYC 거절 사유 거절 코드 및 사유StringKYC 결과 정보
kyc.commentCodeKYC 거절 사유를 나타내는 코드 거절 코드 및 사유StringKYC 결과 정보
kyc.attempts[i].attemptCnt실패 후 재시도한 횟수NumberKYC 시도 정보
kyc.attempts[i].errorCode얼굴 인식, 비교 확인 중 발생한 오류 코드StringKYC 시도 정보
kyc.attempts[i].errorMsg얼굴 인식, 비교 확인 중 발생한 오류 메시지StringKYC 시도 정보
kyc.attempts[i].step1Time1ststep1 첫 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].step1Time2ndstep1 두 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].step1Time3rdstep1 세 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].step2Time1ststep2 첫 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].step2Time2ndstep2 두 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].step2Time3rdstep2 세 번째 호출 시간StringKYC 시도 정보
kyc.attempts[i].retryMsg얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 메시지StringKYC 시도 정보
kyc.attempts[i].retryCode얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 코드StringKYC 시도 정보
kyc.attempts[i].faceSimilarityScore얼굴 비교 유사도 점수FloatKYC 시도 정보
kyc.attempts[i].selfieImage제출된 셀피 이미지의 URLStringKYC 시도 정보
kyc.attempts[i].livenessScore시도의 생체 인증 점수FloatKYC 시도 정보
kyc.attempts[i].liveness생체 인증 점수의 상세 데이터 (score, probability, quality 포함)ObjectKYC 시도 정보
kyc.attempts[i].liveness.score생체 인증의 전체 점수FloatKYC 시도 정보
kyc.attempts[i].liveness.probability생체 인증의 확률 값FloatKYC 시도 정보
kyc.attempts[i].liveness.quality생체 인증의 품질 점수FloatKYC 시도 정보
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얼굴 나이 검증 정보
amlAML 스크리닝 결과를 포함하는 객체ObjectAML 스크리닝 정보
aml.raw_dataAML 스크리닝의 원시 데이터ObjectAML 스크리닝 정보
aml.risk_level_summary리스크 수준 요약 (Not Screened, High, Medium, Low) Risk LevelEnumAML 스크리닝 정보
aml.currentstatusAML 스크리닝의 현재 상태 (Not Screened, Red Flag) AML Screening StatusEnumAML 스크리닝 정보
aml.matchesAML 스크리닝의 상세 매칭 결과ArrayAML 스크리닝 정보
aml.matches[i].risk_level레드 플래그 위험 수준 (HIGH, MEDIUM, LOW) AML Screening InfoEnumAML 스크리닝 정보
aml.matches[i].argos_numberAML 보고서를 조회하기 위한 고유 IDStringAML 스크리닝 정보
aml.matches[i].resource_idAML 보고서를 조회하기 위한 리소스 고유 IDStringAML 스크리닝 정보
aml.matches[i].scoreAML 스크리닝 매칭 점수FloatAML 스크리닝 정보
aml.matches[i].risk_iconsAML 스크리닝 위험 아이콘ArrayAML 스크리닝 정보
nextpageKey추가 페이지를 호출할 때 필요한 키Object페이지 네비게이션 정보
nextpageKey.id마지막으로 조회된 제출 IDString페이지 네비게이션 정보
nextpageKey.created_at마지막으로 조회된 제출의 생성 시간String페이지 네비게이션 정보
projection해당 서브미션에 적용된 Projection 정보를 포함하는 객체ObjectProjection Info
projection.projectionId해당 제출건에 적용된 Projection의 IDStringProjection Info
projection.projectionName해당 제출건에 적용된 Projection의 이름StringProjection Info
tokenIdPrivate mode에서 제출 시 사용된 Token IDString제출 정보
pre_verificationpre_verification 객체 목록objectpre_verification 정보
pre_verification.request_idpre_verification의 요청 IDStringpre_verification 정보
pre_verification.created_at요청 타임스탬프Stringpre_verification 정보
pre_verification.ip_address요청 IP 주소Stringpre_verification 정보
pre_verification.fraud_score사기 점수Numberpre_verification 정보
pre_verification.attempts_frequency서브넷 시도 빈도: [0=‘FirstSeen’, 19=‘Rare’, 1029=‘Frequent’, 30+=‘VeryFrequent’]Stringpre_verification 정보
pre_verification.country_code요청된 IP 주소의 국가 코드Stringpre_verification 정보
pre_verification.connection_type연결 유형: [‘Residential’, ‘Corporate’, ‘Education’, ‘Mobile’, ‘DataCenter’]Stringpre_verification 정보
pre_verification.is_validpre_verification이 실패인지 통과인지의 상태Booleanpre_verification 정보

5-3. 오류 코드

에러 코드메시지설명
invalid_payloadInvalid payload요청 본문을 파싱할 수 없음
missing_dataRequired input data is missing필수 필드가 누락됨
invalid_projectInvalid project프로젝트 ID가 유효하지 않음
invalid_adminInvalid admin관리자 계정에 이 프로젝트에 대한 권한이 없음
invalid_parameterinvalid parameter: {parameter}예상치 못한 매개변수가 제출됨
invalid_formatinvalid format: ${parameter}매개변수가 예상 형식과 일치하지 않음
processing_errorFailed 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
   }
}