🇨🇴 RUNT — 운전면허

엔드포인트

GET https://api.verifik.co/v2/co/runt/conductor

RUNT 에 등록된 운전면허 정보를 명의자 documentType·documentNumber 로 조회합니다. 면허 상태, 카테고리, 적성·의무 교육 관련 데이터, 제재·과태료 요약 등이 응답에 포함될 수 있습니다.

헤더(Headers)

Name	Value
Accept	application/json
Authorization	Bearer <token>

매개변수(Parameters)

name	type	required	description
documentType	string	yes	문서 유형. API 허용: CC, CE, PA, PPT.
documentNumber	string	yes	운전자 문서 번호(공백·마침표 없음).

요청(Request)

Node.js

import axios from "axios";

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

Python

import os, requests

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

응답(Response)

200

{
	"data": {
		"documentType": "CC",
		"documentNumber": "63535709",
		"fullName": "ARLETH PATRICIA RUEDA CORREA",
		"driverStatus": "ACTIVO",
		"citizenStatus": "ACTIVA",
		"licenses": [
			{
				"category": "B1",
				"status": "ACTIVA",
				"dueDate": "19/09/2034",
				"expeditionDate": "19/09/2024"
			}
		],
		"infractions": {
			"tieneMultas": "NO"
		}
	},
	"signature": {
		"dateTime": "October 10, 2025 7:29 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "3R2V0"
}

404

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

409

{
	"code": "MissingParameter",
	"message": "missing documentType. missing documentNumber"
}

참고(Notes)

• 응답 필드는 RUNT 원천 데이터에 따라 달라질 수 있습니다.
• 제품 UI에 다른 문서 유형이 보일 수 있으나, 이 경로의 검증은 CC, CE, PA, PPT 입니다.