Colômbia — Certificados Ministério do Trabalho (v3)

Este ponto de acesso retorna certificados do Ministério do Trabalho 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.

O que esta API retorna

• 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

Ponto de acesso

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.

Cabeçalhos

Nome	Valor
Accept	application/json
Authorization	Bearer <token>

Parâmetros

nome	tipo	obrigatório	descrição
documentType	string	sim	Um de CC, CE, PPT, PA.
documentNumber	string	sim	Número do documento sem espaços ou pontuação.

Requisição

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

Resposta

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

Recursos

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

Casos de uso

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

Notas

• 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.