Colombie — Certificats Ministère du Travail (v3)

Ce point d'accès renvoie les certificats du Ministère du Travail 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.

Ce que renvoie l'API

• 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

Point d'accès

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.

En-têtes

Nom	Valeur
Accept	application/json
Authorization	Bearer <token>

Paramètres

nom	type	requis	description
documentType	string	oui	L'une de CC, CE, PPT, PA.
documentNumber	string	oui	Numéro de document sans espaces ni ponctuation.

Requête

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

Réponse

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

Fonctionnalités

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

Cas d'usage

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