1. Base URL https://rest-api.argosidentity.com/v3/faceauth 2. 인증 x-api-key 헤더에 API 키를 포함시켜야 합니다:
3. 요청 예시 curl -X GET "https://rest-api.argosidentity.com/v3/faceauth" \ -H "x-api-key: {yourAPIKey}" \ 4. 요청 파라미터 특정 제출 건(단 건) 조회 시 사용. 해당 authId를 제출하면 단일 데이터를 조회하며, 미제출 시 전체 리스트가 조회됨
조회 시작 일자 (yyyy-mm-dd or ISO string 형식) 특정 기간 내 데이터를 조회하려면 startDate와 endDate를 함께 제출해야 함
조회 종료 일자 (yyyy-mm-dd or ISO string 형식).
이전 요청의 Response에서 반환된 nextPage_key 객체의 authId 값.
이전 요청의 Response에서 반환된 nextPage_key 객체의 createTime 값.
조회할 데이터 개수 지정 (최소 1 ~ 최대 2,000). 미제출 시 기본값은 2,000건.
4.1 요청 파라미터들을 url에 추가한 예시 curl -X GET "https://rest-api.argosidentity.com/v3/faceauth?authId={authId}&startDate={startDate}&endDate={endDate}&nextKey_id={nextKey_id}&nextKey_date={nextKey_date}&count={count}"" \ -H "x-api-key: {yourAPIKey}" \
최대 조회 가능 개수: 한 번의 요청에서 최대 2,000건을 조회할 수 있습니다.
추가 데이터 조회: 조회할 데이터가 더 있는 경우, 응답(Response)에 nextPage_key 객체가 포함됩니다.
이후 데이터를 조회할 때는 nextPage_key 객체의 authId 값을 nextKey_id로, createTime 값을 nextKey_date로 전달하여 요청해야 합니다.
5. 응답 5-1. Response (delete_check:false) [ { "faceAuth_projectId" : "sampleProjectId1" , "data" : [ { "policy" : { "faceSimilarity_threshold" : 85 , "occluded_threshold" : false , "faceCover_threshold" : 0 , "headCover_threshold" : 0 , "liveness_threshold" : 0 , "activeLiveness_threshold" : 0 }, "auth_id" : "sampleId1" , "auth_status" : "rejected" , "create_time" : "2025-10-02T02:15:17.554Z" , "submit_type" : "form" , "kyc_submission_id" : "sampleKycId1" , "delete_check" : false , "result" : { "active_liveness_score" : 97.78668212890625 , "face_similarity" : 100 , "detectOccluded" : true }, "reject_comment" : [ "face is occluded and the confidence is higher than threshold." ], "fail_code" : [ "Face_Occluded_fail" ] }, { "policy" : { "faceSimilarity_threshold" : 85 , "occluded_threshold" : false , "faceCover_threshold" : 0 , "headCover_threshold" : 0 , "liveness_threshold" : 0 , "activeLiveness_threshold" : 0 }, "auth_id" : "sampleId2" , "auth_status" : "rejected" , "create_time" : "2025-10-02T02:15:17.554Z" , "submit_type" : "form" , "kyc_submission_id" : "sampleKycId1" , "delete_check" : true , "delete_time" : "2025-10-09T03:18:18.046Z" "result" : { "active_liveness_score" : 97.78668212890625 , "face_similarity" : 100 , "detectOccluded" : true }, "reject_comment" : [ "face is occluded and the confidence is higher than threshold." ], "fail_code" : [ "Face_Occluded_fail" ] } ], "nextPage_key" : { "authId" : "sampleId2" , "createTime" : "2025-10-02T02:15:17.554Z" } } ] 5-2. Response (delete_check:true) [ { "auth_id" : "sampleId1" , "aurh_status" : "approved" , "create_time" : "2023-08-18T15:00:00.000Z" , "submit_type" : "sampleType" , "kyc_submission_id" : "sampleKycId1" , "policy" : { "faceSimilarity_threshold" : 70 , "occluded_threshold" : false , "faceCover_threshold" : 0 , "headCover_threshold" : 50 }, "delete_check" : true , "delete_time" : "2023-09-04T02:19:01.399Z" , "result" : { "active_liveness_score" : 97.78668212890625 , "face_similarity" : 100 , "detectOccluded" : true }, } ] 5-2. 응답 예시 조회된 제출 건들의 배열 개별 제출 건 객체 인증에 적용된 임계값 정책 객체 얼굴 가림 감지 (고글, 마스크, 보호구 착용) 임계값
인증 결과 (예: approved, rejected)
faceAuth가 수행된 KYC 제출 건의 ID
인증 결과 데이터 객체 얼굴 가림 감지 (고글, 마스크, 보호구 착용) 결과 값
다음 페이지 조회를 위한 키 객체 다음 페이지 조회를 위한 키의 create_time
5-3. 에러 코드 오류가 발생하면 400 상태 코드와 함께 응답 본문에 세부 정보가 포함됩니다:
{ traceId : ' 0199 cb 93 -bdf 1-77 ef -8 cd 4-3 d 38 dec 61830 ' , errorCode : 'NOT_FOUND' , message : 'faceAuth_project not found' } 에러 코드 설명 faceAuth_project not found제출한 API-Key에 해당하는 유효한 프로젝트가 없을 경우 발생하는 오류입니다.입력한 API-Key가 올바른지 다시 확인해주세요.
