🇨🇴 法曹資格証明（有効性）

エンドポイント

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 は連携要件に合わせて選んでください。