---
title: 데이터 검증
description: 지정된 CPF에 대한 등록 데이터, PEP/AML 스크리닝, 스포츠 관련성을 조회합니다.
canonical: https://developer.unico.io/ko/developers/regional-solutions/data-verification
locale: ko
generated_by: markdown-export
---

- [/ko/](/ko/)
- 지역별 솔루션
- 데이터 검증

**이 페이지에서# 데이터 검증

### 엔드포인트​

환경URL**프로덕션**`POST https://api.idcloud.unico.app/lists/{cpf}`**샌드박스**`POST https://api.idcloud.uat.unico.app/lists/{cpf}`
설계상 별도의 엔드포인트이 엔드포인트는 표준 프로세스 생성(`POST /processes/v1`)과는 별개입니다. 결정론적인 신원 확인 결과가 아니라 데이터 목록을 반환합니다.
### 요청​

헤더
헤더값`Authorization``Bearer <access_token>` (참조: [인증](/ko/developers/start/authentication))
경로 매개변수
매개변수타입필수설명`cpf`string예조회할 사람의 CPF.
```
curl -X POST "https://api.idcloud.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`boolean만 18세 미만 여부를 나타냅니다.

`lists.riskData.pep` — 정치적 주요인물(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일**에