Colombia — Judicial processes

Verifik’s Judicial processes endpoint returns a list of legal processes from Colombia’s judicial system for a given CC (natural person) or NIT (company). Typical fields include process dates, last action, court office (despacho), department, and sujetosProcesales, with pagination when there are many matches.

API Reference

Endpoint

GET https://api.verifik.co/v2/co/rama/procesos

Send documentType and documentNumber as query parameters.

Data-source limitation: Judicial Branch lookups are driven by name resolution tied to the document, not only raw ID fields. Match quality can vary, so Verifik does not guarantee a complete or successful hit on every request.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

Name	Type	Required	Description
documentType	string	Yes	CC (citizen) or NIT (company tax ID).
documentNumber	string	Yes	Document or NIT number to search.

Request

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/rama/procesos", {
	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/v2/co/rama/procesos"
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())

cURL

curl -sS "https://api.verifik.co/v2/co/rama/procesos?documentType=CC&documentNumber=123456789" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $VERIFIK_TOKEN"

Response

200

{
	"data": {
		"consultedSubject": "MATEO VERIFIK",
		"documentNumber": "123456789",
		"documentType": "CC",
		"list": [
			{
				"idProceso": "123456789",
				"idConexion": "262",
				"llaveProceso": "110014003XXXXXXXXX",
				"fechaProceso": "2007-09-21T00:00:00",
				"fechaUltimaActuacion": "2010-11-27T00:00:00",
				"despacho": "JUZGADO XXX CIVIL MUNICIPAL DE BOGOTÁ ",
				"departamento": "BOGOTÁ",
				"sujetosProcesales": [
					"Demandante: XXXXXX  XXXXX XXXX ",
					"Demandado: XXXX XXXX XXXX XXXX "
				],
				"esPrivado": false
			}
		],
		"pagination": {
			"records": "21",
			"recordsPerPage": "20",
			"pages": "2",
			"page": "1"
		}
	},
	"signature": {
		"dateTime": "March 3, 2022 3:55 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "ABC12"
}

200 (empty list)

{
	"data": {
		"consultedSubject": "MATEO VERIFIK",
		"documentNumber": "123456789",
		"documentType": "CC",
		"list": [],
		"pagination": {
			"records": "0",
			"recordsPerPage": "20",
			"pages": "0",
			"page": "1"
		}
	},
	"signature": {
		"dateTime": "August 31, 2022 3:31 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "XYZ99"
}

404

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

409

{
	"code": "MissingParameter",
	"message": "Validation error (e.g. missing query parameter or documentType not CC or NIT)."
}

Features

• Process list with court, dates, parties, and privacy flag where returned by the source
• Pagination metadata when the registry returns multiple pages
• CC and NIT supported for natural persons and companies

Use Cases

• Legal research and litigation background on people or businesses
• Due diligence and compliance in Colombia

Notes

• documentType must be CC or NIT (validated by the API).
• Source lookups use name-based judicial queries; occasional misses or empty lists are possible even with valid IDs.