Certificado de Vigencia para Profesionales Legales

Endpoint

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

El servicio de Certificado de Vigencia para Profesionales Legales permite a los usuarios verificar el estado actual de profesionales legales en Colombia. Al proporcionar el tipo de documento y número (por ejemplo, CC para Cédula de Ciudadanía) junto con el parámetro de calidad deseado, los usuarios pueden acceder a información detallada sobre la certificación del profesional. La respuesta incluye la calidad del profesional (por ejemplo, Abogado para abogado), estado actual (por ejemplo, Vigente para activo), fechas de creación y expedición, un identificador único para el currículum del profesional y otros detalles relevantes.

Encabezados

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción	Ejemplo
documentType	String	Sí	Tipo de documento. Parámetros válidos: CC, NIT, CE.	CC
documentNumber	String	Sí	Número de documento de la persona a consultar.	123456789
quality	String	Sí	Tipo de profesional a consultar. Parámetros válidos: ABG, JUEZPAZ, LT.	ABG

Solicitud

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

Respuesta

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 (Parámetros Faltantes)

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

409 (Tipo de Documento Inválido)

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

409 (Calidad Inválida)

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

Características

• Verificación Profesional: Verificar el estado actual de profesionales legales en Colombia
• Múltiples Tipos Profesionales: Soporte para ABG (Abogado), JUEZPAZ (Juez de Paz) y LT (Técnico Legal)
• Seguimiento de Estado: Verificar si el profesional está actualmente activo (Vigente) o inactivo
• Detalles de Certificación: Acceder a fechas de creación y expedición de certificaciones profesionales
• Identificación Única: Obtener identificador único de currículum para cada profesional
• Información de Licencia: Acceder a números de licencia profesional y detalles
• Respuesta Estructurada: Formato de datos organizado para fácil integración
• Múltiples Lenguajes de Programación: Soporte para JavaScript, Python, PHP y Swift
• Manejo de Errores: Respuestas de error comprensivas para varios escenarios

Casos de Uso

• Verificación Profesional: Verificar credenciales y estado de profesionales legales
• Debida Diligencia: Verificar estado profesional durante consultas legales
• Verificación de Cumplimiento: Asegurar que los profesionales legales cumplan con requisitos actuales
• Verificaciones de Antecedentes: Verificar historial profesional y estado actual
• Servicios Legales: Validar profesionales antes de contratar sus servicios