Colombia — Certificados Ministerio del Trabajo (v3)

Este endpoint devuelve información de certificados del Ministerio del Trabajo para una persona en Colombia, incluyendo datos asociados al curso de alturas, desde el microservicio de Bogotá. La integración v3 devuelve el objeto completo y expone las filas de certificados en records (mapeado desde constances en origen).

Qué devuelve la API

• records — filas de certificados / constancias
• Otros campos que envíe el microservicio en data
• Respuesta firmada por Verifik

Referencia de API

Endpoint

GET https://api.verifik.co/v3/co/ministerio-de-trabajo/certificados

Solo GET con query. La ruta legacy v2 usa los mismos parámetros con otra forma de respuesta; ver notas.

Resumen: documentType, documentNumber.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parámetros

name	type	required	description
documentType	string	sí	Uno de CC, CE, PPT, PA.
documentNumber	string	sí	Número sin espacios ni signos.

Solicitud

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v3/co/ministerio-de-trabajo/certificados", {
	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/v3/co/ministerio-de-trabajo/certificados"
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())

Respuesta

200

{
	"data": {
		"records": []
	},
	"signature": {
		"dateTime": "January 16, 2024 3:44 PM",
		"message": "Certified by Verifik.co"
	}
}

404

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

409

{
	"code": "MissingParameter",
	"message": "documentType must be one of [CC, CE, PPT, PA]"
}

Características

• Tipos: CC, CE, PPT, PA
• v3 mapea constances → records
• Solo GET por query

Casos de uso

• Verificación de curso de alturas
• Cumplimiento laboral y contratistas

Notas

• Si no hay información de curso de alturas puede devolverse 404 (“No registra información en Curso de Alturas.”).
• /v2/co/ministerio-de-trabajo/certificados devuelve un objeto distinto; usa v3 si necesitas el payload completo con records.
• Datos personales / laborales; cumple la normativa aplicable.