Colombia — Ministry of Labor certificates (v3)

This endpoint returns Ministry of Labor certificate information for a Colombian individual, including data associated with height / occupational safety training (curso de alturas), sourced from Verifik’s Bogotá microservice. The v3 handler returns the full microservice payload and exposes certificate rows under records (mapped from the upstream constances field).

Use it for employment compliance, contractor onboarding, and workplace safety checks where this registry is allowed.

What this API returns

• records — list of certificate / constance rows returned by the integration (renamed from upstream constances)
• Any additional fields returned by the microservice on data (structure may evolve with the source)
• A signed Verifik response

API reference

Endpoint

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

GET with query parameters only for this route (no POST on the v3 router). The legacy v2 path uses the same parameter names with a different response shape; see Notes.

Query summary: documentType, documentNumber.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

name	type	required	description
documentType	string	yes	One of CC, CE, PPT, PA.
documentNumber	string	yes	Document number without spaces or punctuation.

Request

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())

Response

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]"
}

Features

• Document types: CC, CE, PPT, PA
• v3 response maps constances → records on the payload returned to the client
• GET query parameters

Use cases

• Height-work and safety training verification
• Employer due diligence and contractor compliance

Notes

• Upstream errors when the person has no height-course information may surface as 404 with a message such as “No registra información en Curso de Alturas.”
• The v2 endpoint /v2/co/ministerio-de-trabajo/certificados uses the same microservice but returns a narrower payload (certificate array only in some paths); prefer v3 when you need the full object plus records.
• Microservice token and availability are environment-dependent; outages may return 5xx errors.
• Treat results as personal / labor data under Colombian law and your policies.