Certificate of Validity for Legal Professionals

Endpoint

https://api.verifik.co/v2/co/rama/certificado/vigencia

The Certificate of Validity for Legal Professionals service allows users to verify the current status of legal professionals in Colombia. By providing the document type and number (e.g., CC for Cédula de Ciudadanía) along with the desired quality parameter, users can access detailed information about the professional's certification. The response includes the professional's quality (e.g., Abogado for lawyer), current status (e.g., Vigente for active), creation and issuance dates, a unique identifier for the professional's resume, and other relevant details.

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, CE.	CC
documentNumber	String	Yes	Document number of the person to consult.	123456789
quality	String	Yes	Type of professional to consult. Valid parameters: ABG, JUEZPAZ, LT.	ABG

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/co/rama/certificado/vigencia',
  params: {
    documentType: 'CC',
    documentNumber: '123456789',
    quality: 'ABG'
  },
  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/certificado/vigencia?documentType=CC&documentNumber=123456789&quality=ABG", 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/certificado/vigencia?documentType=CC&documentNumber=123456789&quality=ABG', [
  '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/certificado/vigencia?documentType=CC&documentNumber=123456789&quality=ABG")! 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": {
    "certificado": "",
    "documentNumber": "123456789",
    "documentType": "CC",
    "encalidad": "Abogado",
    "estado": "Vigente",
    "fechaCreacion": "30/05/2014",
    "fechaExpedicion": "2014/05/30",
    "idHojaDeVida": "5757153a-0e73-e123-80f1-001234b16b17",
    "motivoNoVigencia": " - ",
    "numeroTarCarLice": "123456",
    "observacionesPenaAccesoria": null
  },
  "signature": {
    "dateTime": "April 5, 2024 2:17 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "CHKEH"
}

404

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

409 (Missing Parameters)

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

409 (Invalid Document Type)

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

409 (Invalid Quality)

{
  "code": "MissingParameter",
  "message": "Quality must be one of: [ABG,JUEZPAZ,LT]"
}

Features

• Professional Verification: Verify the current status of legal professionals in Colombia
• Multiple Professional Types: Support for ABG (Abogado), JUEZPAZ (Juez de Paz), and LT (Legal Technician)
• Status Tracking: Check if professional is currently active (Vigente) or inactive
• Certification Details: Access creation and issuance dates of professional certifications
• Unique Identification: Get unique resume identifier for each professional
• License Information: Access professional license numbers and details
• 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

• Professional Verification: Verify the credentials and status of legal professionals
• Due Diligence: Check professional status during legal consultations
• Compliance Verification: Ensure legal professionals meet current requirements
• Background Checks: Verify professional history and current status
• Legal Services: Validate professionals before engaging their services