GET/Submission/applicantId

주의사항

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

1. 엔드포인트

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

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

2. 인증

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

x-api-key

x-api-key: {yourAPIKey}

3. 요청 파라미터

string

필수

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

4. 요청 예시

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

curl --location --request GET 'https://kr.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

5-3. 오류 코드

오류가 발생하면 403 상태 코드와 함께 다음 오류 문구가 반환됩니다:

오류 코드	HTTP 상태	설명
`project not found`	403	프로젝트 조회에 실패함
`not exist applicantId`	403	`applicant_id`가 누락됨
`get applicants info fail`	403	applicant 조회에 실패함

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

시작하기

‘ID check API는 기업 고객이 KYC(Know Your Customer) 및 AML(Anti-Money Laundering) 프로세스를 보다 체계적이고 효율적으로 관리할 수 있도록 설계된 솔루션입니다. 이 API는 기존 시스템과의 원활한 통합을 지원하며, 사용자 데이터를 안전하게 처리하고 관리할 수 있는 기능을 제공합니다.

GET/Submission 응답 필드 정의

GET/Submission API 응답에 포함되는 모든 필드에 대한 상세 정의

웹훅 이벤트

ARGOS ID check의 KYC 프로세스 상태 변경을 실시간으로 확인하세요. 웹훅을 통해 즉각적인 업데이트를 받아볼 수 있습니다.

개요

API 참조

GET/Submission/applicantId

1. 엔드포인트

2. 인증

3. 요청 파라미터

4. 요청 예시

5. 응답

5-1. 성공 응답

5-2. 응답 데이터

5-3. 오류 코드

관련 문서

시작하기

GET/Submission 응답 필드 정의

웹훅 이벤트

​1. 엔드포인트

​2. 인증

​3. 요청 파라미터

​4. 요청 예시

​5. 응답

​5-1. 성공 응답

​5-2. 응답 데이터

​5-3. 오류 코드

​관련 문서

시작하기

GET/Submission 응답 필드 정의

웹훅 이벤트

1. 엔드포인트

2. 인증

3. 요청 파라미터

4. 요청 예시

5. 응답

5-1. 성공 응답

5-2. 응답 데이터

5-3. 오류 코드

관련 문서