Colombia - Contratos Públicos

Endpoint

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

El servicio de Contratos Públicos permite a los usuarios recuperar una lista de contratos públicos asociados con 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 monitoreo de contratos públicos con el estado en Colombia.

Headers

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

Parámetros

Nombre	Tipo	Requerido	Descripción
documentType	string	Sí	Tipo de Documento. Parámetros permitidos: CC, NIT.
documentNumber	string	Sí	Número de Documento a solicitar

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

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

conn.request("GET", "/v2/co/contracts?documentType=CC&documentNumber=63535790", headers=headers)

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

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

Swift

import Foundation

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

let request = NSMutableURLRequest(url: NSURL(string: "https://api.verifik.co/v2/co/contracts?documentType=CC&documentNumber=63535790")! 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()

PHP

<?php

$client = new \GuzzleHttp\Client();

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

echo $response->getBody();

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"
        }
      ]
    },
    "signature": {
      "dateTime": "May 24, 2023 4:41 PM",
      "message": "Certified by Verifik.co"
    }
  }
}

404

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

409 (Parámetros Faltantes)

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

409 (Tipo de Documento Inválido)

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

Features

• Public Contracts Verification: Query public contracts associated with persons or companies
• Detailed Information: Returns complete contract details including values, entities and dates
• Transparency: Promotes transparency in public contracting
• 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