기존 등록 프로필 찾기
API 계정에 연결된 로컬 등록 프로필 중 활성 상태이며 삭제되지 않은 프로필의 목록을 조회합니다. 이 목록에서 프로필 UUID를 찾은 다음 get_document로 해당 프로필을 열 수 있습니다. 이 목록을 증빙 자료나 번호 등록의 승인 여부를 판단하는 데 사용하지 마세요.
목록 조회 요청
활성화된 MultiTEL API 계정과 해당 계정에 허용된 IP 주소를 사용하여 인증하세요. 예제에서는 환경 변수에 저장된 HTTP Basic 인증 정보를 사용합니다. HTTP 응답과 JSON status.code를 모두 확인하세요. HTTP 200 응답만으로는 성공 여부를 판단할 수 없습니다. 예제에 사용된 모든 값은 가상의 값입니다.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/documents이 핸들러에는 요청 본문, 페이지 나누기 또는 필터 매개변수가 구현되어 있지 않습니다. 해당 계정에 저장된 프로필을 반환하며, 특정 순서로 정렬된다고 가정해서는 안 됩니다. 대규모 계정에서는 전체 목록을 자주 폴링하지 마세요.
응답 목록
{
"status": {
"code": 200,
"msg": ""
},
"response": [
{
"id": "11111111111111111111111111111111",
"first_name": "Example",
"last_name": "Person",
"phone_number": "12025550123",
"id_number": "",
"birth_date": null,
"company_name": "",
"company_reg_number": "",
"vat_id": "",
"personal_tax_id": "",
"description": "Example profile",
"identity_type": "Personal",
"postal_code": "00000",
"city": "Example City",
"address": "1 Example Street",
"signature": "BASE64_PNG_SIGNATURE_DATA",
"date_created": "2026-10-23 16:00:00"
}
]
}조건에 맞는 활성 프로필이 없으면 핸들러는 API 코드 200과 빈 응답 목록을 반환합니다. response[].id는 생성 시 uuid로 반환된 로컬 프로필 UUID이며, 신원 ID나 주소 ID가 아닙니다.
반환되는 프로필 필드
반환되는 필드는 다음과 같습니다: id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature 및 date_created.
선택 항목의 값은 저장된 데이터에 따라 비어 있거나 null일 수 있습니다. 이 레거시 반환 필드에는 email, 국가 선택 항목, identity_id, address_id, 업로드된 파일 참조, 증빙 자료 목록 및 검증 상태가 포함되지 않습니다. 이 엔드포인트는 증빙 자료의 상태나 등록 승인 여부를 확인하는 용도가 아닙니다. 반환된 신원 정보, 연락처 정보 및 서명 데이터는 비공개 정보로 취급하세요.
다음 단계
나중에 첨부 항목을 연결할 수 있도록 원래 create_document 응답에 포함된 엔터티 ID를 저장하세요. 해당 응답을 잃어버렸다면 이 목록으로는 그 ID를 복구할 수 없습니다. 프로필은 포털에서 확인하거나 지원팀에 문의하세요. 중복 프로필을 자동으로 생성하지 마세요.