RUNT

Description

Returns the driver information stored in Colombia's RUNT (Registro Único Nacional de Tránsito) for a given identity document.

HTTP method GET

Endpoint

https://api.msla-id.com/experience-idv-drivinglicense-api-v1/api/idv-govcheck/v1/co-identity/{documentType}/{documentNumber}/runt

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

info

Before proceeding, make sure you have your jwt token, if you don't have it, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

Path request parameter

NAME	REQUIRED	TYPE	DESCRIPTION	EXAMPLE
documentType	✅	string	Type of identity document. Validated against the list of document types accepted by RUNT (VALID_RUNT_DOCUMENT_TYPES). Values: CC (Citizenship ID), CE (Foreigner ID), TI (Identity Card), RC (Civil Registry), PS (Passport), CD (Diplomatic ID).	CC
documentNumber	✅	string	Identity document number.	1102386764

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error
504	Gateway timeout

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "34372f63ac42d547",
    "timestamp": "2026-08-14 15:26:08",
    "data": {
        "personData": {
            "documentNumber": "1102386764",
            "documentType": "01",
            "country": "co",
            "nameInfo": {
                "firstName": "ALISSON",
                "secondName": null,
                "paternalSurname": "MARTINEZ",
                "maternalSurname": null,
                "nameType": 2
            }
        },
        "registrationNumber": "21399430",
        "registrationDate": "2022-02-10",
        "driverStatus": "ACTIVO",
        "personStatus": "ACTIVA",
        "hasFines": "NO",
        "clearanceNumber": "835364673061",
        "drivingLicenses": [
            {
                "licenseNumber": "1102386764",
                "issuingOffice": "STRIA TTOyMOV PIEDECUESTA/SANTANDER",
                "issueDate": "2022-08-01",
                "licenseStatus": "ACTIVA",
                "restrictions": "CONDUCIR CON LENTES",
                "licenseDetails": [
                    {
                        "category": "A2",
                        "issueDate": "2022-08-01",
                        "expirationDate": "2032-08-01",
                        "examExpirationDate": ""
                    }
                ]
            }
        ],
        "drivingAptitudeCertificates": [
            {
                "certificateNumber": "19622539",
                "drivingSchoolName": "C.E.A PRACTI - CAR DELACUESTA",
                "issueDate": "2022-07-11",
                "category": "A2",
                "certificateType": "CERTIFICADO CONDUCTOR",
                "status": "UTILIZADO",
                "requestNumber": "186984602",
                "requestDate": "2022-07-11",
                "fupaNumber": "600000000071919953",
                "requestedProcedure": "Trámite expedición licencia conducción"
            }
        ],
        "driverRequests": [
            {
                "requestNumber": "268681093",
                "requestDate": "",
                "identifier": "SKW18E",
                "requestStatus": "AUTORIZADA",
                "procedureStatus": "APROBADO",
                "proceduresPerformed": "16",
                "entity": "STRIA MCPAL TTOyTTE GIRON",
                "registry": "RNA",
                "procedureName": "TRÁMITE TRASPASO"
            }
        ]
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2026-08-14 15:26:08",
    "code": "IDV-3002",
    "message": "Bad Request - Document number is invalid, it must be a number.",
    "data": null
}

Response 401 status code

{
    "timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
    "status": 401,
    "error": "Unauthorized",
    "path": "/api/idv-govcheck/v1/co-identity/{documentType}/{documentNumber}/runt"
}

Response 404 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1002",
    "message": "Data not found."
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administrator.",
    "data": null
}

Response 504 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1100",
    "message": "Gateway Timeout"
}