--- title: 데이터 검증 description: 주어진 CPF에 대한 등록 데이터, PEP/AML 심사 및 스포츠 관계를 조회합니다. canonical: https://developer.unico.io/ko/dual-api/developers/api-reference/api/get-lists locale: ko generated_by: markdown-export --- - [/ko/](/ko/) - [API 레퍼런스](/ko/dual-api/developers/api-reference/) - [API](/ko/dual-api/developers/api-reference/api/) - 데이터 검증 **이 페이지에서# 데이터 검증 ### 엔드포인트​ 환경URL**프로덕션**`POST https://api.id.unico.app/lists/{cpf}`**샌드박스**`POST https://api.id.uat.unico.app/lists/{cpf}` 설계상 별도 엔드포인트이 엔드포인트는 표준 프로세스 생성(`POST /processes/v1`)과는 분리되어 있습니다. 결정론적 신원 확인 결과가 아닌 데이터 목록을 반환합니다. ### 요청​ 헤더 헤더값`Authorization``Bearer ` ([인증](/ko/dual-api/developers/api-reference/authentication) 참조) 경로 매개변수 매개변수유형필수 여부설명`cpf`string예조회할 사람의 CPF. ``` curl -X POST "https://api.id.uat.unico.app/lists/12345678909" \ -H "Authorization: Bearer $TOKEN" ``` ### 응답​ 루트 엔벨로프 ``` { "id": "41c24382-36ce-4bb4-8339-352114f71f78", "status": 3, "lists": { }} ``` 필드유형설명`id`string (UUID)고유 요청 식별자.`status`integer처리 상태.`lists`object조회된 데이터가 포함된 메인 페이로드. `lists.basicData` — 등록 데이터 ``` { "basicData": { "name": "JOAO DA SILVA", "birthCountry": "BRASILEIRA", "birthDate": "1990-01-01T00:00:00Z", "gender": "M", "motherName": "MARIA DA SILVA", "fatherName": "", "maritalStatus": "", "rgNumber": "", "rgIssuingAgency": "", "rgStateCode": "", "financialData": { "incomeEstimate": "...", "totalAssets": "..." }, "address": { "addressMain": "AVENIDA DO ESTADO", "number": "123", "complement": "ANDAR 1", "neighborhood": "CENTRO", "zipCode": "12345678", "city": "SAO PAULO", "state": "SP", "country": "BRASIL", "type": "WORK" }, "email": "...", "phone": "+554799999999", "socialName": "" }} ``` 필드유형설명`name`string전체 이름.`birthCountry`string출생 국가.`birthDate`string (ISO 8601)생년월일.`gender`string성별.`motherName`string어머니 이름.`fatherName`string아버지 이름.`maritalStatus`string결혼 여부.`rgNumber`stringRG 번호.`rgIssuingAgency`stringRG 발급 기관.`rgStateCode`stringRG 주 코드.`financialData.incomeEstimate`string수입 추정액.`financialData.totalAssets`string총 자산.`email`string이메일.`phone`string전화번호.`socialName`string사회적 이름. 등록된 사회적 이름이 없는 경우 비어 있을 수 있습니다. **`basicData.address`:** 필드유형설명`addressMain`string도로명.`number`string번지.`complement`string상세 주소.`neighborhood`string동네.`zipCode`string우편번호.`city`string도시.`state`string주 코드.`country`string국가.`type`string주소 유형 (예: `WORK`). `lists.riskData.taxIdValidation` — CPF 검증 ``` { "taxIdValidation": { "taxIdStatus": "REGULAR", "taxIdStatusDate": "...", "decease": false, "under18": false }} ``` 필드유형설명`taxIdStatus`stringCPF 등록 상태.`taxIdStatusDate`string등록 상태 날짜.`decease`boolean사망 여부를 나타냅니다.`under18`boolean18세 미만 여부를 나타냅니다. `lists.riskData.pep` — 정치적 노출 인물 ``` { "pep": { "isCurrentlyPep": true, "records": [ { "level": "1", "jobTitle": "SENADOR", "motive": "FEDERAL EMPLOYEE" } ] }} ``` 필드유형설명`isCurrentlyPep`boolean현재 PEP인지 여부.`records`array본인의 PEP 기록.`records[].level`string정치적 노출 수준.`records[].jobTitle`string직책.`records[].motive`string분류 사유. `lists.riskData.aml` — 자금 세탁 방지 (제재) ``` { "aml": { "isSanctioned": true, "records": [ { "type": "Law Enforcement", "source": "interpol", "standardizedType": "ARREST WARRANTS", "endDate": "..." } ] }} ``` 필드유형설명`isSanctioned`boolean제재 대상인지 여부.`records`array본인의 제재 내역.`records[].type`string제재 유형.`records[].source`string제재 출처.`records[].standardizedType`string표준화된 유형.`records[].endDate`string종료일. `lists.riskData.sportsRelationship` — 스포츠 베팅 관계 ``` { "sportsRelationship": { "hasSportsRelationship": false, "isCurrentlyAthlete": false, "isCurrentlySportsCoach": false, "isCurrentlySportsClubDirector": false, "isCurrentlyReferee": false, "isCurrentlyRelatedToFinanceMinistry": false, "isCurrentlyBettingCompanyOwner": false, "sportsRelationshipMotive": "", "sportExposures": [] }} ``` 필드유형설명`hasSportsRelationship`boolean스포츠 관계가 있는지 여부.`isCurrentlyAthlete`boolean현역 선수인지 여부.`isCurrentlySportsCoach`boolean현역 코치인지 여부.`isCurrentlySportsClubDirector`boolean현역 클럽 이사인지 여부.`isCurrentlyReferee`boolean현역 심판인지 여부.`isCurrentlyRelatedToFinanceMinistry`boolean재무부와 관계가 있는지 여부.`isCurrentlyBettingCompanyOwner`boolean베팅 회사 소유주인지 여부.`sportsRelationshipMotive`string관계 사유.`sportExposures`array상세 스포츠 노출 내역. **`sportExposures[]`:** 필드유형설명`sportName`string스포츠 이름.`region`string활동 지역.`totalRelatedEntities`integer총 관련 기관 수.`relationshipLevel`string관계 수준.`endDate`string종료일. ### 오류 코드​ 400 Bad Request403 Forbidden500 Internal Server Error코드메시지설명`99989`The document is invalid.CPF가 유효하지 않은 경우.코드메시지설명`10501`The authorization token is invalid.인증 토큰이 유효하지 않습니다.코드메시지설명`99999`Internal failure! Try again later내부 오류가 발생한 경우.마지막 업데이트 2026년 10월 8일**에