🇨🇴Contratos Públicos

Servicio para consultar los contratos públicos que ha recibido un ciudadano o empresa.

Contratos Públicos

GET - https://api.verifik.co/v2/co/contracts

El servicio de Contratos Públicos permite a los usuarios obtener una lista de los contratos públicos asociados a una persona o empresa proporcionando su número de documento y tipo de documento. La respuesta incluye detalles valiosos sobre cada contrato, como información del contratista, valores del contrato, entidades involucradas, duración del contrato y más. Este servicio promueve la transparencia y facilita el seguimiento de los contratos públicos con el Estado en Colombia.

Implementación

Headers

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

Query Parameters

Name	Type	Required?	Descripction	Example
documentType	String	True	Document Type. Allowed Parameters: CC, NIT.	CC
documentNumber	String	True	Document Number to request	123456789

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/co/contracts>',
  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")
payload = ''
headers = {}
conn.request("GET", "/v2/co/contracts?documentType=CC&documentNumber=63535790", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/co/contracts?documentType=CC&documentNumber=63535790")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/co/contracts?documentType=CC&documentNumber=63535790');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Response

200

{
  "value": {
    "data": {
      "contractor": [
        {
          "contractor": "123456789",
          "contractor_name": "MATEO VERIFIK",
          "count": 19
        }
      ],
      "contracts": [
        {
          "contractor_reference": "18486325807904513",
          "contractor_id": "63535790",
          "contractor": "DIANA ROCIO GARCIA PEÑARANDA",
          "entity_id": "824002672",
          "entity": "CESAR ESE HOSPITAL CAMILO VILLAZON PUMAREJO PUEBLO BELLO",
          "url": "<https://www.contratos.gov.co/consultas/detalleProceso.do?numConstancia=18-4-8632580>",
          "value": 1250000,
          "object": "PRESTACION DE SERVICIOS PARA EL MANTENIMIENTO PREVENTIVO PLANIFICADO Y CORRECTIVO DE LOS EQUIPOS BIOMEDICOS DE LAS DISTINTAS AREAS DE LA ESE HOSPITAL CAMILO VILLAZON PUMAREJO DE PUEBLO BELLO  CESAR",
          "process_id": "4",
          "department": "CESAR",
          "contract_start_date": "2018-11-01",
          "contract_end_date": "2018-11-16"
        },
        {
          "contractor_reference": "18482197577489423",
          "contractor_id": "63535790",
          "contractor": "DIANA ROCIO GARCIA PEÑARANDA",
          "entity_id": "824002672",
          "entity": "CESAR ESE HOSPITAL CAMILO VILLAZON PUMAREJO PUEBLO BELLO",
          "url": "<https://www.contratos.gov.co/consultas/detalleProceso.do?numConstancia=18-4-8219757>",
          "value": 3500000,
          "object": "PRESTACION DE SERVICIOS PARA EL MANTENIMIENTO PREVENTIVO PLANIFICADO Y CORRECTIVO DE LOS EQUIPOS BIOMEDICOS DE LAS DISTINTAS AREAS DE LA ESE HOSPITAL CAMILO VILLAZON PUMAREJO DE PUEBLO BELLO  CESAR",
          "process_id": "4",
          "department": "CESAR",
          "contract_start_date": "2018-07-17",
          "contract_end_date": "2018-08-16"
        },
        {
          "contractor_reference": "181275855486892482",
          "contractor_id": "63535790",
          "contractor": "SOLUCIONES BIOMEDICASDIANA ROCIO GARCIA PEÑARANDA",
          "entity_id": "890500810",
          "entity": "SANTANDER ESE HOSPITAL MENTAL RUDESINDO SOTO CUCUTA",
          "url": "<https://www.contratos.gov.co/consultas/detalleProceso.do?numConstancia=18-12-7585548>",
          "value": 5951904,
          "object": "EL CONTRATISTA SE COMPROMETE CON LA ESE HOSPITAL MENTAL RUDESINDO SOTO A REALIZAR MANTENIMIENTO PREVENTIVO Y CORRECTIVO DE LOS EQUIPOS BIOMEDICOS DE LA INSTITUCION SEGUN ALCANCE ESTIMADO EN LA PROPUESTA QUE HACE PARTE INTEGRAL DEL PRESENTE CONTRATO",
          "process_id": "12",
          "department": "NORTE DE SANTANDER",
          "contract_start_date": "2018-01-19",
          "contract_end_date": "2018-12-15"
        },
        {
          "contractor_reference": "18488007408066152",
          "contractor_id": "63535790",
          "contractor": "DIANA ROCIO GARCIA PEÑARANDA",
          "entity_id": "824002672",
          "entity": "CESAR ESE HOSPITAL CAMILO VILLAZON PUMAREJO PUEBLO BELLO",
          "url": "<https://www.contratos.gov.co/consultas/detalleProceso.do?numConstancia=18-4-8800740>",
          "value": 1825000,
          "object": "COMPRAVENTA DE ACCESORIOS Y DISPOSITIVOS MEDICOS PARA LA E S E HOSPITAL CAMILO VILLAZON PUAMREJO DEL MUNICIPIO DE PEUBLO BELLO  CESAR",
          "process_id": "4",
          "department": "CESAR",
          "contract_start_date": "2018-12-24",
          "contract_end_date": "2018-12-29"
        },
        {
          "contractor_reference": "18483663017649982",
          "contractor_id": "63535790",
          "contractor": "DIANA ROCIO GARCIA PEÑARANDA",
          "entity_id": "824002672",
          "entity": "CESAR ESE HOSPITAL CAMILO VILLAZON PUMAREJO PUEBLO BELLO",
          "url": "<https://www.contratos.gov.co/consultas/detalleProceso.do?numConstancia=18-4-8366301>",
          "value": 5000000,
          "object": "PRESTACION DE SERVICIOS PARA EL MANTENIMIENTO PREVENTIVO PLANIFICADO Y CORRECTIVO DE LOS EQUIPOS BIOMEDICOS DE LAS DISTINTAS AREAS DE LA ESE HOSPITAL CAMILO VILLAZON PUMAREJO DE PUEBLO BELLO  CESAR",
          "process_id": "4",
          "department": "CESAR",
          "contract_start_date": "2018-08-17",
          "contract_end_date": "2018-10-17"
        },
        {
          "contractor_reference": "171263158685745254",
          "contractor_id": "63535790",
          "contractor": "SOLUCIONES BIOMEDICASDIANA ROCIO GARCIA PEÑARANDA",
          "entity_id": "890500810",
          "entity": "SANTANDER ESE HOSPITAL MENTAL RUDESINDO SOTO CUCUTA",
          "url": "<https://www.contratos.gov.co/consultas/detalleProceso.do?numConstancia=17-12-6315868>",
          "value": 4760000,
          "object": "EL CONTRATISTA SE COMPROMETE CON LA ESE HOSPITAL MENTAL RUDESINDO SOTO A REALIAR MANTENIMIENTO PREVENTIVO Y CORRECTIVO DE LOS EQUIPOS BIOMEDICOS DE LA INSTITUCION SEGUN ALCANCE ESTIMADO EN LA PROPUESTA QUE HACE PARTE INTEGRAL DE LA PRESENTE ORDEN",
          "process_id": "12",
          "department": "NORTE DE SANTANDER",
          "contract_start_date": "2017-02-27",
          "contract_end_date": "2017-12-24"
        },
        {
          "contractor_reference": "2041119662910372672",
          "contractor_id": "63535790",
          "contractor": "DIANA ROCIO GARCIA PEÑARANDA",
          "entity_id": "824002672",
          "entity": "CESAR ESE HOSPITAL CAMILO VILLAZON PUMAREJO PUEBLO BELLO",
          "url": "<https://www.contratos.gov.co/consultas/detalleProceso.do?numConstancia=20-4-11196629>",
          "value": 5000000,
          "object": "CONTRATO DE COMPRAVENTA DE MASCARILLAS QUIRURGICASPARA LA E S E HOSPITAL CAMILO VILLAZON PUAMREJO DELMUNICIPIO DE PEUBLO BELLO  CESAR",
          "process_id": "4",
          "department": "CESAR",
          "contract_start_date": "2020-10-08",
          "contract_end_date": "2020-10-23"
        }
      ]
    },
    "signature": {
      "dateTime": "May 24, 2023 4:41 PM",
      "message": "Certified by Verifik.co"
    }
  }
}

404

{
"code": "NotFound",
"message": "Record not found.",
"signature": {
"dateTime": "August 31, 2022 3:24 PM",
"message": "Certified by Verifik.co"
}
}

409

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

409

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