GET/Submission

Last updated 2 months ago

Request URL

curl -X GET "https://rest-api.argosidentity.com/v3/submission?submission_id={submission_id}"
-H "x-api-key: {yourAPIKey}"

제출 목록을 가져옵니다.

KYC/AML 상태는 GET 요청으로 확인할 수 있습니다.
특정 제출의 KYC 상태를 확인하거나 GET 요청과 함께 KYC 제출 목록을 얻을 수 있습니다.
매개 변수가 제공되지 않으면 모든 제출 목록이 반환됩니다.
매개 변수가 제공된 경우 지정된 매개 변수를 기준으로 목록을 필터링합니다.
특정 제출의 제출 데이터를 가져오려면 제출 ID(submission_id)를 매개 변수로 제공해야 합니다. 자세한 내용은 아래 Input Data 테이블을 참조해 주세요.

Input Data

*이 붙은 것은 필수 파라미터 입니다. (Get submission은 필수 파라미터가 없습니다.)

파라미터

설명

암호화 옵션 사용 시 Input Data

2024.06.21

암호화 옵션 사용 시, Input 및 Output 의 양 방향 암/복호화 추가

Input 객체(Query String Parameter)를 암호화한 후, data 프로퍼티로 전송.

queryStringParameters : {
	data : encrypt({
		email : 'string',
		start_date : 'string',
		end_date : 'string'
	})
}

Output Data

Response

설명

Sample Response - Specific Submission

{
    "Items": [
        {
            "data": {
                "name": "{name}",
                "gender": "male",
                "nationality": "KOR",
                "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": "KOR",
                "idcard_issueDate": "YYYY-MM-DD",
                "idType": "government_id",
                "identityNumber": "{******-*******}"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "updated_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "reviewer": "{reviewer}",
      "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",
                        "verificationResult": "success",
                        "verification": {
                            "result": {
                                "code": "CF-00000",
                                "message": "성공",
                                "transactionId": "{transactionId}",
                                "extraMessage": ""
                            },
                            "data": {
                                "resUserIdentiyNo": "*************",
                                "resAuthenticity": "1",
                                "resAuthenticityDesc": "입력하신 내용은 등록된 내용과 일치합니다.",
                                "resUserNm": "{resUserNm}"
                            }
                        },
                        "verificationParams": {
                            "fullName": "{fullName}",
                            "idType": "government_id",
                            "issueDate": "{YYYY-MM-DD}",
                            "identityNumber": "******-*******"
                        },
                        "step2Time1st": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "liveness": {
                            "score": 8.097455,
                            "probability": 0.9996958,
                            "quality": 0.7537264
                        },
                        "faceSimilarityScore": 0,
                        "retryMsg": [
                            "The face doesn’t match. Please retry with another face image."
                        ],
                        "livenessScore": 99,
                        "selfieImage": "{selfieImage URL}",
                        "retryCode": [
                            "face_compare_underscore"
                        ]
                    },
                    {
                        "attemptCnt": 2,
                        "verificationResult": "success",
                        "verification": {
                            "result": {
                                "code": "CF-00000",
                                "message": "성공",
                                "transactionId": "{transactionId}",
                                "extraMessage": ""
                            },
                            "data": {
                                "resUserIdentiyNo": "*************",
                                "resAuthenticity": "1",
                                "resAuthenticityDesc": "입력하신 내용은 등록된 내용과 일치합니다.",
                                "resUserNm": "{resUserNm}"
                            }
                        },
                        "verificationParams": {
                            "fullName": "{fullName}",
                            "idType": "government_id",
                            "issueDate": "{YYYY-MM-DD}",
                            "identityNumber": "******-*******"
                        },
                        "step2Time2nd": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "liveness": {
                            "score": 8.097455,
                            "probability": 0.9996958,
                            "quality": 0.7537264
                        },
                        "faceSimilarityScore": 0,
                        "retryMsg": [
                            "The face doesn’t match. Please retry with another face image."
                        ],
                        "livenessScore": 99,
                        "selfieImage": "{selfieImage URL}",
                        "retryCode": [
                            "face_compare_underscore"
                        ]
                    },
                    {
                        "attemptCnt": 3,
                        "verificationResult": "success",
                        "verification": {
                            "result": {
                                "code": "CF-00000",
                                "message": "성공",
                                "transactionId": "{selfieImage URL}",
                                "extraMessage": ""
                            },
                            "data": {
                                "resUserIdentiyNo": "*************",
                                "resAuthenticity": "1",
                                "resAuthenticityDesc": "입력하신 내용은 등록된 내용과 일치합니다.",
                                "resUserNm": "{resUserNm}"
                            }
                        },
                        "verificationParams": {
                            "fullName": "{fullName}",
                            "idType": "government_id",
                            "issueDate": "{YYYY-MM-DD}",
                            "identityNumber": "981112-1******"
                        },
                        "step2Time3rd": "YYYY-MM-DD-HH-MM-SS-ZZZ",
                        "liveness": {
                            "score": 8.097455,
                            "probability": 0.9996958,
                            "quality": 0.7537264
                        },
                        "faceSimilarityScore": 0,
                        "retryMsg": [
                            "The face doesn’t match. Please retry with another face image."
                        ],
                        "livenessScore": 99,
                        "selfieImage": "{selfieImage URL}",
                        "retryCode": [
                            "face_compare_underscore"
                        ]
                    }
                ]
            }
        }
    ]
}

암호화 옵션 사용 시 Output Data

Body 내 ‘data’ 프로퍼티에 암호화 된 결과 반환

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

Reject Code & Comment

kyc.commentCode

kyc.comment

GET/Submission/Submission ID

특정 Submission ID의 정보를 조회합니다.

URL과 x-api-key 를 반드시 입력해야 합니다
반드시 Query Params로 조회해야 합니다.
단 건만 조회가 가능합니다.
KYC 신원 정보 데이터, KYC 결과, AML 결과, 거절 사유 및 코드, 재시도 사유 및 코드 등을 확인할 수 있습니다.

Request URL

curl -X GET "https://rest-api.argosidentity.com/v3/submission?submission_id={submission_id}"\
-H "x-api-key: {yourAPIKey}"

Sample Request

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

Sample Response

{
    "Items": [
        {
            "data": {
                "name": "홍길동",
                "gender": "male",
                "nationality": "KOR",
                "date_of_birth": "YYYY-MM-DD",
                "cf1": "{cf1}",
                "ip_address": "XXX.XXX.XXX.XXX",
                "idcard_issuingCountry": "KOR",
                "idcard_issueDate": "YYYY-MM-DD",
                "idType": "government_id"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "userid": "{userid}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "Multiple invalid KYC attempts "
                ],
                "commentCode": [
                    "too_many_retry"
                ],
                "attempts": [
                    {
                        "attemptCnt": 1,
                        "retryMsg": [
                            "Liveness fail: Face is too close to one or more borders. Please retry."
                        ],
                        "retryCode": [
                            "liveness_error"
                        ]
                    },
                    {
                        "attemptCnt": 2,
                        "retryMsg": [
                            "Liveness fail: Absolute face size is too small. Please retry."
                        ],
                        "retryCode": [
                            "liveness_error"
                        ]
                    },
                    {
                        "attemptCnt": 3,
                        "livenessScore": 99
                        "retryMsg": [
                            "The face doesn’t match. Please retry with another face image."
                        ],
                        "retryCode": [
                            "face_compare_underscore"
                        ]
                    }
                ]
            }
        }
    ]
}

GET/Submission/User ID

특정 user_id를 가지고 있는 제출 건을 조회합니다.

URL과 x-api-key 를 반드시 입력해야 합니다.
반드시 Query Params로 조회해야 합니다.
동일한 userid로 제출된 모든 KYC 데이터(submission)가 조회 됩니다.

Request URL

curl -X GET "https://rest-api.argosidentity.com/v3/submission?userid={userid}"\
-H "x-api-key: {yourAPIKey}"

Sample Request

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

Sample Response

{
	"Items": [
        {
            "data": {
                "name": "{name}",
                "gender": "male",
                "nationality": "KOR",
                "date_of_birth": "YYYY-MM-DD"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
						"userid" : "{userid}" 
            "reviewer": "{reviewer}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "Multiple invalid KYC attempts "
                ],
                "commentCode": [
                    "too_many_retry"
                ]
            }
        },
        {
            "data": {
                "name": "{name}",
                "gender": "male",
                "nationality": "BRA",
                "date_of_birth": "YYYY-MM-DD"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "pending_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
						"userid" : "{userid}"
            "reviewer": "{reviewer}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "test"
                ],
                "commentCode": [
                    "other"
                ]
            }
        },
        {
            "data": {
                "name": "{name}",
                "gender": "male",
                "nationality": "KOR",
                "date_of_birth": "YYYY-MM-DD"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "userid" : "{userid}",
            "reviewer": "{reviewer}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "Multiple invalid KYC attempts "
                ],
                "commentCode": [
                    "too_many_retry"
                ]
	           }
	        }
			 }
	  ]
}

GET/Submission/Email

특정 이메일의 제출 건을 조회합니다.

URL과 x-api-key 를 반드시 입력해야 합니다.
반드시 Query Params로 조회해야 합니다.
동일한 email로 제출된 모든 KYC 데이터(submission)가 조회 됩니다.
KYC 신원 정보 데이터, KYC 결과, AML 결과, 거절 사유 및 코드, 재시도 사유 및 코드 등을 확인 할 수 있습니다.

Request URL

curl -X GET "https://rest-api.argosidentity.com/v3/submission?email={email}"\
-H "x-api-key: {yourAPIKey}"

Sample Request

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

Sampel Response

{
	"Items": [
        {
            "data": {
                "name": "{name}",
                "gender": "male",
                "nationality": "KOR",
                "date_of_birth": "YYYY-MM-DD"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "reviewer": "{reviewer}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "Multiple invalid KYC attempts "
                ],
                "commentCode": [
                    "too_many_retry"
                ]
            }
        },
        {
            "data": {
                "name": "{name}",
                "gender": "male",
                "nationality": "BRA",
                "date_of_birth": "YYYY-MM-DD"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "pending_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "reviewer": "{reviewer}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "test"
                ],
                "commentCode": [
                    "other"
                ]
            }
        },
        {
            "data": {
                "name": "{name}",
                "gender": "male",
                "nationality": "KOR",
                "date_of_birth": "YYYY-MM-DD"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "reviewer": "{reviewer}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "Multiple invalid KYC attempts "
                ],
                "commentCode": [
                    "too_many_retry"
                ]
	           }
	        }
			 }
	  ]
}

GET/Submission/List

전체 리스트로 조회합니다.

URL과 x-api-key 를 반드시 입력해야 합니다.
반드시 Query Params로 조회해야 합니다.
제출된 모든 KYC데이터(submission)가 조회 됩니다.
KYC 신원 정보 데이터, KYC 결과 AML 결과, 거절 사유 및 코드, 재 시도 사유 및 코드 등을 확인 할 수 있습니다.

Request URL

curl -X GET "https://rest-api.argosidentity.com/v3/submission"\
-H "x-api-key: {yourAPIKey}"

Sample Request

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

Sample Response

"Items": [
        {
            "data": {
                "name": "{name}",
                "gender": "male",
                "nationality": "KOR",
                "date_of_birth": "YYYY-MM-DD"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "reviewer": "{reviewer}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "Multiple invalid KYC attempts "
                ],
                "commentCode": [
                    "too_many_retry"
                ]
            }
        },
        {
            "data": {
                "name": "{name}",
                "gender": "male",
                "nationality": "BRA",
                "date_of_birth": "YYYY-MM-DD"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "pending_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "reviewer": "{reviewer}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "test"
                ],
                "commentCode": [
                    "other"
                ]
            }
        },
        {
            "data": {
                "name": "{name}",
                "gender": "male",
                "nationality": "KOR",
                "date_of_birth": "YYYY-MM-DD"
            },
            "email": "{email}",
            "submission_id": "{submission_id}",
            "created_at": "YYYY-MM-DD-HH-MM-SS-ZZZ",
            "reviewer": "{reviewer}",
            "kyc": {
                "result": "rejected",
                "comment": [
                    "Multiple invalid KYC attempts "
                ],
                "commentCode": [
                    "too_many_retry"
                ]
            }
        }
		}
]

GET/Submission/Applicant ID

중복으로 제출된 KYC 데이터의 고유 식별 ID(submission_id)와 이메일을 확인할 수 있습니다.

이름, 생년월일, 국적, 성별, 얼굴이 같은 사람의 submission이 다수 있을 경우 중복 제출로 판단하며, 중복 제출된 submission들을 확인 할 수 있습니다.
중복으로 제출하지 않은 일반적인 제출자의 경우 승인된 단일 submission만 가져옵니다.
applicant_id를 기준으로 조회하기 때문에, Get/submission API를 사용하여 applicant_id 정보를 확인해야 합니다.
applicant_id는 신원정보(name, date of birth, gender, nationality) 와 Selfie 총 5가지의 데이터를 비교합니다.
- 5가지의 데이터가 동일한 KYC 제출 데이터에 대해서 동일한 applicant_id를 생성합니다.
- 비교대상 정보가 없는 경우 랜덤으로 값을 생성합니다.

Request URL

curl -X GET "https://rest-api.argosidentity.com/v3/submission/applicant?applicant_id={applicant_id}"
-H "x-api-key: {yourAPIKey}"

Input Data

*이 붙은 것은 필수 파라미터 입니다.

파라미터

설명

Output Data

응답

설명

Sample Request

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

Sample Response

[
    {
        "submission_id": "{submission_id}",
        "email": "{email}"
    },
    {
        "submission_id": "{submission_id}",
        "email": "{email}"
    },
    {
        "submission_id": "{submission_id}",
        "email": "{email}"
    }
]