🇨🇴 법률인 자격 증명(유효성)

엔드포인트

GET https://api.verifik.co/v2/co/rama/certificado/vigencia

콜롬비아 법조인 등록·증명 유효성을 확인합니다. 쿼리로 documentType(반드시 CC 또는 CE), documentNumber, quality(예: ABG, JUEZPAZ, LT)를 보냅니다. 응답 필드 encalidad 철자는 API 원문을 따릅니다.

헤더(Headers)

Name	Value
Accept	application/json
Authorization	Bearer <token>

매개변수(Parameters)

name	type	required	description
documentType	string	yes	CC 또는 CE만 허용.
documentNumber	string	yes	조회할 신분증 번호.
quality	string	yes	직군 코드(예: ABG, JUEZPAZ, LT).

요청(Request)

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/rama/certificado/vigencia", {
	params: { documentType: "CC", documentNumber: "123456789", quality: "ABG" },
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/rama/certificado/vigencia"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789", "quality": "ABG"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

응답(Response)

200

{
	"data": {
		"certificado": "",
		"documentNumber": "123456789",
		"documentType": "CC",
		"encalidad": "Abogado",
		"estado": "Vigente",
		"fechaCreacion": "30/05/2014",
		"fechaExpedicion": "2014/05/30",
		"idHojaDeVida": "5757153a-0e73-e123-80f1-001234b16b17",
		"motivoNoVigencia": " - ",
		"numeroTarCarLice": "123456",
		"observacionesPenaAccesoria": null
	},
	"signature": {
		"dateTime": "April 5, 2024 2:17 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "CHKEH"
}

404

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

409

{
	"code": "MissingParameter",
	"message": "유효성 오류(쿼리 누락·오류 또는 documentType이 CC/CE가 아님)."
}

참고(Notes)

• documentType 은 CC·CE 만 허용됩니다(NIT 불가).
• quality 는 연동 시나리오에 맞는 코드를 사용하세요.