Driver's License Validation in RUNT (Basic)
Same driver lookup as Premium v2 (GET /v2/co/runt/conductor), billed at the Basic conductor price. You must send primerApellido (minimum 2 characters) for every document type, including TI. Omitting it returns 409 MissingParameter. This endpoint does not look up the surname and does not add the RUI price.
Use this path when you already know the first last name. Sending primerApellido on v2 is billed at this same Basic price.
v2 and v3
Premium GET /v2/co/runt/conductor | Basic GET /v3/co/runt/conductor | |
|---|---|---|
Surname (primerApellido) | Not required, except PA, which requires it. Verifik finds the surname when you omit it. | Required for every document type (minimum 2 characters). |
| Document types | CC, TI, CE, PA, PPT | CC, TI, CE, PA, PPT |
| Billing | Omit the surname: Premium. For TI with no surname, the driver list price plus the RUI list price (GET /v2/co/rui). Send the surname: Basic, the same price as v3. | Basic conductor price. No surname lookup and no RUI price. |
Endpoint
GET https://api.verifik.co/v3/co/runt/conductor
Headers
| Name | Value |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
documentType | string | Yes | One of CC, TI, CE, PA, PPT. PA is passport, PPT is not. TI is tarjeta de identidad. |
documentNumber | string | Yes | Driver's document number, without spaces or periods. |
primerApellido | string | Yes | First last name (minimum 2 characters). Required for every document type, including TI. |
Document types
| Code | Full name | Who holds it | RUNT label | primerApellido |
|---|---|---|---|---|
CC | Cédula de Ciudadanía | Colombian citizens (national ID) | C. | Required |
TI | Tarjeta de Identidad | Colombian tarjeta de identidad | — | Required |
CE | Cédula de Extranjería | Foreign residents in Colombia | E. | Required |
PA | Pasaporte (passport) | Passport holders | P. | Required |
PPT | Permiso por Protección Temporal | Venezuelan temporary-protection permit — not a passport | Y. | Required |
Request
- Node.js
- Python
- curl (TI)
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v3/co/runt/conductor", {
params: {
documentType: "CC",
documentNumber: "123456789",
primerApellido: "GARCIA",
},
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v3/co/runt/conductor"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789", "primerApellido": "GARCIA"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
curl -G "https://api.verifik.co/v3/co/runt/conductor" \
-H "Accept: application/json" \
-H "Authorization: Bearer $VERIFIK_TOKEN" \
--data-urlencode "documentType=TI" \
--data-urlencode "documentNumber=1002003001" \
--data-urlencode "primerApellido=EJEMPLO"
documentNumber and primerApellido above are fake. primerApellido is required. This call is billed at the Basic conductor price and does not add the RUI price.
Response
- 200
- 409
{
"data": {
"documentType": "TI",
"documentNumber": "1002003001",
"fullName": "ANA MARIA EJEMPLO FICTICIO",
"driverStatus": "ACTIVO",
"citizenStatus": "ACTIVA",
"licenses": [
{
"category": "A2",
"status": "ACTIVA",
"dueDate": "01/06/2034",
"expeditionDate": "01/06/2024"
}
]
},
"signature": {
"dateTime": "January 15, 2026 12:00 PM",
"message": "Certified by Verifik.co"
}
}
The values above are fake. A live TI response uses the same fields as Premium v2.
{
"code": "MissingParameter",
"message": "\"primerApellido\" is required"
}
Notes
- One API request at the Basic conductor price, including
TIwhen you sendprimerApellido. - Without
primerApellidothis endpoint does not look up the surname and does not add the RUI price. - Accepted
documentTypevalues areCC,TI,CE,PA, andPPT. - For automatic surname resolution, use
/v2/co/runt/conductor. On that endpoint,TIwithoutprimerApellidois billed as the driver list price plus the RUI list price.