주의사항

  • applicant_id는 신원정보(이름, 생년월일, 성별, 국적)와 Selfie 총 5가지 데이터를 비교하여 생성됩니다.
  • 중복 제출이 없는 경우, 승인된 단일 submission만 반환됩니다.
  • applicant_id 정보는 GET/submission API를 통해 먼저 확인해야 합니다.
  • 비교 대상 정보가 없는 경우 랜덤으로 applicant_id가 생성됩니다.

1. 엔드포인트

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

2. 인증

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

x-api-key
x-api-key: {yourAPIKey}

3. 요청 파라미터

applicant_id
string
required

중복 제출을 확인하기 위해 부여되는 고유 식별 ID로, KYC 상태가 승인일 때만 전달 됩니다.

4. 요청 예시

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

5. 응답

5-1. 성공 응답

result.json
[
    {
        "submission_id": "{submission_id1}",
        "duplicated_information" : "{duplicated_information}",
        "email": "{email1}"
    },
    {
        "submission_id": "{submission_id2}",
        "duplicated_information" : "{duplicated_information}",
        "email": "{email2}"
    },
    {
        "submission_id": "{submission_id3}",
        "duplicated_information" : "{duplicated_information}",
        "email": "{email3}"
    }
]

5-2. 응답 데이터

필드명설명데이터 타입
submission_id중복제출로 확인된 submission의 고유 값String
duplicated_information이름, 생년월일, 성별, 국적을 기준으로 중복 확인용 식별자가 생성됩니다. (*네 가지 기준이 모두 제공되면 항상 생성됩니다.)String
email중복 제출로 확인된 submission에 기록된 이메일 주소String

이 API를 통해 중복 제출된 KYC 데이터를 효과적으로 관리하고 모니터링할 수 있습니다.