Colombian Legal Processes

Endpoint

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

The Colombian Legal Processes service provides detailed information about legal processes associated with a Colombian citizen or company. By supplying a valid Colombian document number, users can access a list of legal processes related to the individual or entity. The response includes information such as the date of the process, the last date of action, the office where it was processed, and the subjects involved.

Note: The Judicial Branch queries are made using names rather than exact identification card data. As a result, Verifik cannot guarantee a 100% successful response due to this limitation in the data source.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Parameters

Name	Type	Required	Description	Example
documentType	String	Yes	Document type. Valid parameters: CC, NIT.	CC
documentNumber	String	Yes	Document number of the person from whom you want to seek legal proceedings.	123456789

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/rama/procesos',
  params: {
    documentType: 'CC',
    documentNumber: '123456789'
  },
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")

headers = {
    'Accept': "application/json",
    'Authorization': "JWT token"
}

conn.request("GET", "/v2/co/rama/procesos?documentType=CC&documentNumber=123456789", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

PHP

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.verifik.co/v2/co/rama/procesos?documentType=CC&documentNumber=123456789', [
  'headers' => [
    'Accept' => 'application/json',
    'Authorization' => 'JWT token',
  ],
]);

echo $response->getBody();

Swift

import Foundation

let headers = [
  "Accept": "application/json",
  "Authorization": "JWT token"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/co/rama/procesos?documentType=CC&documentNumber=123456789")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()

Response

200

{
  "data": {
    "documentType": "CC",
    "documentNumber": "123456789",
    "consultedSubject": "MATEO VERIFIK",
    "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"
    }
  }
}

200 (Empty)

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

404

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

409 (Missing Parameters)

{
  "code": "MissingParameter",
  "message": "missing documentType\n. missing documentNumber\n"
}

409 (Invalid Document Type)

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

Features

• Legal Process Discovery: Find all legal processes associated with a Colombian citizen or company
• Comprehensive Information: Access detailed process information including dates, courts, and parties involved
• Pagination Support: Handle large result sets with built-in pagination
• Judicial Branch Integration: Direct access to Colombian judicial system data
• Multiple Document Types: Support for CC (Citizen ID) and NIT (Tax ID) documents
• Structured Response: Organized data format for easy integration
• Multiple Programming Languages: Support for JavaScript, Python, PHP, and Swift
• Error Handling: Comprehensive error responses for various scenarios

Use Cases

• Legal Research: Investigate legal history of individuals or companies
• Due Diligence: Verify legal status during business transactions
• Background Checks: Comprehensive legal background verification
• Legal Compliance: Ensure compliance with legal requirements
• Court Case Tracking: Monitor ongoing legal proceedings