콜롬비아 — Procuraduría 시민 조회

콜롬비아 문서 번호를 검증하고 Procuraduría General de la Nación에서 이름을 추출합니다. 이 공식 출처는 Cédula de ciudadanía (CC), Cédula de extranjería (CE), Permiso Especial de Permanencia (PEP), NIT, Permiso por Protección Temporal (PPT)를 지원합니다.

문서 번호로 시민 조회 (/v2/co/cedula)와 달리 이 엔드포인트는 Procuraduría만 호출하며 DIAN, ADRES, Registraduría는 시도하지 않습니다. 징계 기록 (/v2/co/procuraduria/antecedentes)과 달리 antecedentes나 legend를 반환하지 않습니다.

이 API가 반환하는 값

• documentNumber, documentType
• firstName, lastName, fullName, arrayName
• 서명된 Verifik 응답

API 참조

Endpoint

GET https://api.verifik.co/v2/co/procuraduria

Procuraduría에서 이름만 필요할 때, /cedula의 다른 출처가 다루지 않는 문서 유형을 포함할 때 이 엔드포인트를 사용하세요. 동일한 연동은 JSON 본문의 **POST**로도 가능합니다. **GET**은 쿼리 매개변수를 사용합니다.

일반 필드: documentType, documentNumber, firstName, lastName, fullName, arrayName. 여러 정부 출처를 통합하려면 /v2/co/cedula를 사용하세요. 징계 이력이 필요하면 /v2/co/procuraduria/antecedentes를 사용하세요.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

name	type	required	description	Examples
documentType	string	yes	CC, CE, PPT, NIT, PEP 중 하나	CE
documentNumber	string	yes	문서 번호, 숫자만	688925

Request

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/procuraduria", {
	params: {
		documentType: "CE",
		documentNumber: "688925",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/procuraduria"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CE", "documentNumber": "688925"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Response

200

{
	"data": {
		"documentType": "CE",
		"documentNumber": "688925",
		"firstName": "JUAN SEBASTIAN",
		"lastName": "RAIGOSA GALLEGO",
		"fullName": "JUAN SEBASTIAN RAIGOSA GALLEGO",
		"arrayName": ["JUAN", "SEBASTIAN", "RAIGOSA", "GALLEGO"]
	},
	"signature": {
		"dateTime": "August 25, 2026 12:00 PM",
		"message": "Certified by Verifik.co"
	}
}

404

{
	"code": "NotFound",
	"message": "Record not found."
}

409

{
	"code": "MissingParameter",
	"message": "documentType must be one of: [CC,CE,PPT,NIT,PEP]"
}

기능

• Procuraduría 이름 직접 조회
• CC, CE, PPT, NIT, PEP 지원
• 징계 기록 없음 (antecedentes, legend)
• GET과 POST가 같은 핸들러를 공유

사용 사례

• 등록된 이름만 필요할 때 외국인 신분증(CE) 또는 NIT 검증
• 다중 소스 /cedula 통합에서 Procuraduría만 분리
• 징계 기록을 별도 과금하고 싶지 않을 때 전용 상품 사용

Notes

• 이름 추출만 — 응답에 antecedentes나 legend가 없습니다.
• 징계 기록은 콜롬비아 징계 기록을 사용하세요.
• /v2/co/cedula는 동일한 문서 유형에 대해 Procuraduría와 다른 출처를 계속 통합합니다.
• 샌드박스 예약 문서 90040401은 404를 반환합니다.
• 관련: 문서 번호로 시민 조회.