The Public Contracts service allows users to retrieve a list of public contracts associated with a person or company by providing their document number and document type. The response includes valuable details about each contract, such as contractor information, contract values, involved entities, contract duration, and more.

This service promotes transparency and facilitates the monitoring of public contracts with the state in Colombia.

Parametros

Nombre Tipo ¿Requerido? Descripción Ejemplo
documentType String True Tipo de documento. Parámetro permitido: CC, NIT. CC
documentNumber String True Número de documento de la persona a consultar. 123456789

Implementación

Consulta

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 {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Respuesta 200 - (Consulta exitosa)

{
  "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"
    }
  }
}

Otras respuestas

Code Descripción Response Body
404 Not Found Información no encontrada {
"code": "NotFound",
"message": "Record not found.",
"signature": {
"dateTime": "August 31, 2022 3:24 PM",
"message": "Certified by Verifik.co"
}
}
409 Conflict Hace falta suministrar algún parámetro. {
"code": "MissingParameter",
"message": "missing documentType\n. missing documentNumber\n"
}
409 Conflict documentType inválido para esta consulta. {
"code": "MissingParameter",
"message": "documentType must be one of: [CC,NIT]"
}