Lookup cce · secop-procurement by PROCESS_ID
https://api.latinfo.dev/co/cce/secop-procurement/process_id/{process_id}
One procurement process in the REQ namespace. Contracts join through its BDOS portfolio identifier; where several contracts match, only one selected contract is retained. Coverage: Published SECOP II processes in the staged snapshot; excludes SECOP I and the offers dataset. Not an exhaustive contract history. Use the public process ID, for example CO1.REQ.100001. coSecopProcess normalizes it to the stored zero-padded numeric-first ID. Search hits expose the stored ID; convert it back to the documented public form before lookup. Corporate identity is a reviewed NIT-shape predicate, not confirmation against RUES or proof of current legal status. Natural-person contractor and awardee names/documents and contractor addresses are redacted; affected free text is scrubbed. Empty fields may be missing, unmatched or redacted and do not establish a negative finding. Only one contract is selected per portfolio; contract values are not totals across all related contracts. bidder_count counts distinct corporate-shaped NITs, not every submission or participant. Process and contract dates are publisher timestamps, never import time. Numbered phase timestamp suffixes are original field names, not inferred chronology. Monetary strings preserve the publisher values in COP without scaling or conversion. Truncated field valor_pendiente_de has no inferred financial category. duracion uses the original unidad_de_duracion; duracion_del_contrato is unparsed publisher text. Funding-source fields are indicators rather than monetary amounts. PPI, PCI, agreement-point and agreement-pillar fields are preserved without expanding undocumented abbreviations or categories. Source data, statuses and privacy redactions do not establish legal clearance, eligibility, ownership or complete procurement coverage. Returns one record. Import time is not observation time; inspect freshness headers.
Source contract
- Publisher
- Colombia Compra Eficiente
- Coverage
- Published SECOP II processes in the staged snapshot; excludes SECOP I and the offers dataset. Not an exhaustive contract history.
- Record meaning
- One procurement process in the REQ namespace. Contracts join through its BDOS portfolio identifier; where several contracts match, only one selected contract is retained.
- Identifier
- Use the public process ID, for example CO1.REQ.100001. coSecopProcess normalizes it to the stored zero-padded numeric-first ID. Search hits expose the stored ID; convert it back to the documented public form before lookup.
- Accepted pattern
^CO\d\.REQ\.\d{1,10}$- Normalization
coSecopProcess- Cardinality
one- License
- Reuse permission has not been verified. Public access is not a reuse license.
Known limitations
- Corporate identity is a reviewed NIT-shape predicate, not confirmation against RUES or proof of current legal status.
- Natural-person contractor and awardee names/documents and contractor addresses are redacted; affected free text is scrubbed. Empty fields may be missing, unmatched or redacted and do not establish a negative finding.
- Only one contract is selected per portfolio; contract values are not totals across all related contracts. bidder_count counts distinct corporate-shaped NITs, not every submission or participant.
- Process and contract dates are publisher timestamps, never import time. Numbered phase timestamp suffixes are original field names, not inferred chronology.
- Monetary strings preserve the publisher values in COP without scaling or conversion. Truncated field valor_pendiente_de has no inferred financial category.
- duracion uses the original unidad_de_duracion; duracion_del_contrato is unparsed publisher text. Funding-source fields are indicators rather than monetary amounts.
- PPI, PCI, agreement-point and agreement-pillar fields are preserved without expanding undocumented abbreviations or categories.
- Source data, statuses and privacy redactions do not establish legal clearance, eligibility, ownership or complete procurement coverage.
Parameters
process_idstringpathrequiredUse the public process ID, for example CO1.REQ.100001. coSecopProcess normalizes it to the stored zero-padded numeric-first ID. Search hits expose the stored ID; convert it back to the documented public form before lookup.
Example: CO1.REQ.0000010001
Request example
curl https://api.latinfo.dev/co/cce/secop-procurement/process_id/CO1.REQ.0000010001 \
-H "Authorization: Bearer $LATINFO_API_KEY"
Responses
200Published source records. Missing data is not a clearance or a negative finding.
Response headers
X-Latinfo-Imported-AtImport time, not the date of the government observation.
X-Source-Updated-AtPublisher update time, when known.
X-Latest-Observation-AtLatest observation date in this response page, when known. For a complete paginated history, preserve each page date or take the maximum date across all pages. Never use import time as observation time.
X-Freshness-Statusstring
CURRENT · DELAYED · STALE · UNKNOWNX-Credits-CostActual credits charged for this request.
X-Source-GenerationOpaque immutable source generation. Follow the guarded next-page Link when collecting a history.
application/jsonResponse fields
process_id string requiredUse the public process ID, for example CO1.REQ.100001. coSecopProcess normalizes it to the stored zero-padded numeric-first ID. Search hits expose the stored ID; convert it back to the documented public form before lookup.
entidad string requiredPublic buying entity name from the process record.
nit_entidad string requiredBuying entity NIT exactly as published; keep leading zeros and punctuation.
departamento_entidad string requiredDepartment of the buying entity in the process record.
ciudad_entidad string requiredCity of the buying entity in the process record.
ordenentidad string requiredPublisher administrative-order label for the buying entity.
codigo_pci string requiredPublisher PCI code for the buying entity; no inferred classification.
referencia_del_proceso string requiredBuying entity's original process reference.
ppi string requiredOriginal PPI value from the process dataset; no expansion or inferred meaning.
id_del_portafolio string requiredSECOP portfolio identifier (BDOS namespace), used to join contracts; distinct from the REQ process identifier.
nombre_del_procedimiento string requiredPublished process title with identified natural-person provider names redacted.
descripcion_del_procedimiento string requiredPublished process description with identified natural-person provider names redacted.
fase string requiredOriginal procurement phase label.
fecha_de_publicacion string requiredProcess publication timestamp from fecha_de_publicacion_del; distinct from import time. Format: ISO 8601 source datetime.
fecha_de_ultima_publicaci string requiredPublisher's last process publication timestamp; not the Latinfo import time. Format: ISO 8601 source datetime.
fecha_de_publicacion_fase string requiredOriginal phase publication timestamp from fecha_de_publicacion_fase. Format: ISO 8601 source datetime.
fecha_de_publicacion_fase_1 string requiredOriginal phase publication timestamp from fecha_de_publicacion_fase_1; suffix does not establish phase order. Format: ISO 8601 source datetime.
fecha_de_publicacion_raw string requiredSeparate original fecha_de_publicacion timestamp; not an alias of fecha_de_publicacion_del. Format: ISO 8601 source datetime.
fecha_de_publicacion_fase_2 string requiredOriginal phase publication timestamp from fecha_de_publicacion_fase_2; suffix does not establish phase order. Format: ISO 8601 source datetime.
fecha_de_publicacion_fase_3 string requiredOriginal phase publication timestamp from fecha_de_publicacion_fase_3; suffix does not establish phase order. Format: ISO 8601 source datetime.
precio_base string requiredOriginal procurement base price, without scaling or currency conversion. Unit: COP.
COP
modalidad_de_contratacion string requiredPublished process procurement-method label.
justificacion_modalidad_de string requiredPublished justification for the process procurement method.
duracion string requiredOriginal process duration; interpret only with unidad_de_duracion. Unit: publisher unit in unidad_de_duracion.
publisher unit in unidad_de_duracion
unidad_de_duracion string requiredPublisher unit label for duracion, preserved without conversion.
fecha_de_recepcion_de string requiredOriginal receipt timestamp from fecha_de_recepcion_de; the importer does not infer the truncated field's event semantics. Format: ISO 8601 source datetime.
fecha_de_apertura_de_respuesta string requiredOriginal response-opening timestamp. Format: ISO 8601 source datetime.
fecha_de_apertura_efectiva string requiredOriginal actual-opening timestamp. Format: ISO 8601 source datetime.
ciudad_de_la_unidad_de string requiredCity of the procurement unit as published.
nombre_de_la_unidad_de string requiredProcurement unit name as published.
proveedores_invitados string requiredPublished count of invited providers. Unit: count.
count
proveedores_con_invitacion string requiredOriginal count from proveedores_con_invitacion; not the derived corporate bidder_count. Unit: count.
count
visualizaciones_del string requiredPublished process-view count. Unit: count.
count
proveedores_que_manifestaron string requiredOriginal provider-interest count from proveedores_que_manifestaron. Unit: count.
count
respuestas_al_procedimiento string requiredPublished procedure-response count. Unit: count.
count
respuestas_externas string requiredPublished external-response count. Unit: count.
count
conteo_de_respuestas_a_ofertas string requiredOriginal offer-response count from conteo_de_respuestas_a_ofertas. Unit: count.
count
proveedores_unicos_con string requiredOriginal unique-provider count from proveedores_unicos_con; no inferred award status. Unit: count.
count
numero_de_lotes string requiredPublished number of procurement lots. Unit: count.
count
estado_del_procedimiento string requiredOriginal process status; not a company compliance or tax status.
id_estado_del_procedimiento string requiredPublisher code for the process status.
adjudicado string requiredOriginal award indicator; preserve the publisher's string value.
id_adjudicacion string requiredOriginal award identifier.
codigoproveedor string requiredPublisher awardee provider code from the process record.
departamento_proveedor string requiredPublished awardee department, independent of conditional name/document redaction.
ciudad_proveedor string requiredPublished awardee city, independent of conditional name/document redaction.
fecha_adjudicacion string requiredPublished award timestamp. Format: ISO 8601 source datetime.
valor_total_adjudicacion string requiredOriginal total awarded amount, without scaling or currency conversion. Unit: COP.
COP
nombre_proveedor_adjudicado string requiredAwardee name retained only when the reviewed corporate-NIT predicate passes; otherwise empty.
nit_proveedor_adjudicado string requiredOriginal awardee NIT retained only when the reviewed corporate-NIT predicate passes; otherwise empty.
codigo_categoria_unspsc string requiredOriginal main UNSPSC procurement category code.
estado_de_apertura_del_proceso string requiredPublished process-opening status.
tipo_de_contrato string requiredContract-type label in the process dataset; distinct from contrato_tipo_de_contrato.
subtipo_de_contrato string requiredContract-subtype label in the process dataset.
categorias_adicionales string requiredAdditional procurement categories as published; no inferred taxonomy expansion.
url_proceso string requiredOriginal official process URL; object-shaped Socrata URLs are reduced to their url value.
codigo_entidad string requiredPublisher buying-entity code from the process dataset.
estado_resumen string requiredPublisher summary-status label.
bidder_count string requiredDerived count of distinct bidder NITs passing the reviewed corporate-NIT predicate; excludes natural-person and malformed identifiers. Unit: count.
count
contract_id string requiredIdentifier of the single joined contract selected for the portfolio; not an exhaustive contract list.
contract_estado string requiredPublished status of the single joined contract.
nombre_entidad string requiredBuying entity name from the joined contract record.
contrato_nit_entidad string requiredOriginal buying entity NIT from the joined contract record.
departamento string requiredBuying entity department from the joined contract record.
ciudad string requiredBuying entity city from the joined contract record.
localizacion string requiredOriginal contract location label from localizaci_n.
orden string requiredOriginal administrative-order label from the joined contract.
sector string requiredOriginal buying-entity sector label from the joined contract.
rama string requiredOriginal buying-entity branch label from the joined contract.
entidad_centralizada string requiredOriginal centralized-entity indicator; preserve its publisher string.
referencia_del_contrato string requiredBuying entity's original contract reference.
codigo_de_categoria_principal string requiredMain procurement category code from the joined contract.
descripcion_del_proceso string requiredContract dataset's process description with identified natural-person provider names redacted.
contrato_tipo_de_contrato string requiredContract-type label from the joined contract; distinct from the process value.
contrato_modalidad_de_contratacion string requiredProcurement-method label from the joined contract.
contrato_justificacion_modalidad_de string requiredProcurement-method justification from the joined contract.
fecha_de_firma string requiredPublished signature timestamp for the joined contract. Format: ISO 8601 source datetime.
fecha_de_inicio_del_contrato string requiredPublished contract-start timestamp. Format: ISO 8601 source datetime.
fecha_de_fin_del_contrato string requiredPublished contract-end timestamp. Format: ISO 8601 source datetime.
condiciones_de_entrega string requiredOriginal contractual delivery-condition text.
tipodocproveedor string requiredContractor document-type label retained only for a contractor with type NIT and a corporate-shaped number; otherwise empty.
documento_proveedor string requiredOriginal contractor document retained only when the reviewed corporate-NIT predicate passes; otherwise empty.
proveedor_adjudicado string requiredContractor name retained only when the reviewed corporate-NIT predicate passes; otherwise empty.
es_grupo string requiredOriginal supplier-group indicator; no corporate ownership inference.
es_pyme string requiredOriginal supplier SME indicator; no independent size verification.
habilita_pago_adelantado string requiredPublisher advance-payment-enabled indicator.
liquidacion string requiredPublisher contract-liquidation indicator.
obligacion_ambiental string requiredPublisher environmental-obligation indicator; not evidence of compliance.
obligaciones_postconsumo string requiredPublisher post-consumer-obligation indicator; not evidence of compliance.
reversion string requiredPublisher reversion indicator.
origen_de_los_recursos string requiredOriginal contract resource-origin label.
destino_gasto string requiredOriginal contract expenditure-destination label.
valor_del_contrato string requiredOriginal total contract value, without scaling or currency conversion. Unit: COP.
COP
valor_de_pago_adelantado string requiredOriginal contractual advance-payment value. Unit: COP.
COP
valor_facturado string requiredOriginal invoiced contract amount. Unit: COP.
COP
valor_pendiente_de_pago string requiredOriginal contract amount pending payment. Unit: COP.
COP
valor_pagado string requiredOriginal paid contract amount. Unit: COP.
COP
valor_amortizado string requiredOriginal amortized contract amount. Unit: COP.
COP
valor_pendiente_de string requiredOriginal amount from valor_pendiente_de; its truncated name must not be interpreted as valor_pendiente_de_pago or valor_pendiente_de_ejecucion. Unit: COP.
COP
valor_pendiente_de_ejecucion string requiredOriginal contract amount pending execution. Unit: COP.
COP
saldo_cdp string requiredOriginal CDP balance; no inferred budget availability or eligibility. Unit: COP.
COP
saldo_vigencia string requiredOriginal balance for the reporting fiscal period. Unit: COP.
COP
espostconflicto string requiredPublisher post-conflict indicator.
dias_adicionados string requiredOriginal number of days added to the contract. Unit: days.
days
puntos_del_acuerdo string requiredPublisher agreement-points value; retained without interpreting its classification.
pilares_del_acuerdo string requiredPublisher agreement-pillars value; retained without interpreting its classification.
contrato_url string requiredOfficial URL from the joined contract record; Socrata URL objects are reduced to url.
presupuesto_general_de_la_nacion_pgn string requiredOriginal national-budget funding indicator; not an amount or percentage.
sistema_general_de_participaciones string requiredOriginal general participation-system funding indicator; not an amount or percentage.
sistema_general_de_regalias string requiredOriginal general royalty-system funding indicator; not an amount or percentage.
recursos_propios_alcaldias_gobernaciones_y_resguardos_indigenas string requiredOriginal own-resource funding indicator for local authorities and indigenous reservations; not an amount or percentage.
recursos_de_credito string requiredOriginal credit-resource funding indicator; not an amount or percentage.
recursos_propios string requiredOriginal own-resource funding indicator; not an amount or percentage.
contrato_codigo_entidad string requiredBuying-entity code from the joined contract.
codigo_proveedor string requiredSupplier code from the joined contract.
objeto_del_contrato string requiredOriginal contract object with identified natural-person provider names redacted.
duracion_del_contrato string requiredOriginal contract-duration text, including any publisher unit; no numeric duration is inferred.
el_contrato_puede_ser_prorrogado string requiredPublisher contract-extension indicator; no legal interpretation.
documentos_tipo string requiredPublisher standard-document indicator.
descripcion_documentos_tipo string requiredPublisher standard-document description.
direccion_de_ejecucion_del_contrato string requiredContract execution address retained only for a corporate contractor; otherwise empty. This is not the company's registered address.
source_system string requiredFixed SECOP_II provenance marker added by the importer.
search_blob string requiredSearch text assembled from redacted process title, description and buying entity, capped at 2000 characters; not the complete original document.
Response schema
{
"type": "object",
"properties": {
"process_id": {
"type": "string",
"description": "Use the public process ID, for example CO1.REQ.100001. coSecopProcess normalizes it to the stored zero-padded numeric-first ID. Search hits expose the stored ID; convert it back to the documented public form before lookup."
},
"entidad": {
"type": "string",
"description": "Public buying entity name from the process record.",
"x-latinfo-meaning": "text"
},
"nit_entidad": {
"type": "string",
"description": "Buying entity NIT exactly as published; keep leading zeros and punctuation.",
"x-latinfo-meaning": "identifier"
},
"departamento_entidad": {
"type": "string",
"description": "Department of the buying entity in the process record.",
"x-latinfo-meaning": "text"
},
"ciudad_entidad": {
"type": "string",
"description": "City of the buying entity in the process record.",
"x-latinfo-meaning": "text"
},
"ordenentidad": {
"type": "string",
"description": "Publisher administrative-order label for the buying entity.",
"x-latinfo-meaning": "text"
},
"codigo_pci": {
"type": "string",
"description": "Publisher PCI code for the buying entity; no inferred classification.",
"x-latinfo-meaning": "code"
},
"referencia_del_proceso": {
"type": "string",
"description": "Buying entity's original process reference.",
"x-latinfo-meaning": "identifier"
},
"ppi": {
"type": "string",
"description": "Original PPI value from the process dataset; no expansion or inferred meaning.",
"x-latinfo-meaning": "text"
},
"id_del_portafolio": {
"type": "string",
"description": "SECOP portfolio identifier (BDOS namespace), used to join contracts; distinct from the REQ process identifier.",
"x-latinfo-meaning": "identifier"
},
"nombre_del_procedimiento": {
"type": "string",
"description": "Published process title with identified natural-person provider names redacted.",
"x-latinfo-meaning": "text"
},
"descripcion_del_procedimiento": {
"type": "string",
"description": "Published process description with identified natural-person provider names redacted.",
"x-latinfo-meaning": "text"
},
"fase": {
"type": "string",
"description": "Original procurement phase label.",
"x-latinfo-meaning": "text"
},
"fecha_de_publicacion": {
"type": "string",
"description": "Process publication timestamp from fecha_de_publicacion_del; distinct from import time. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"fecha_de_ultima_publicaci": {
"type": "string",
"description": "Publisher's last process publication timestamp; not the Latinfo import time. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"fecha_de_publicacion_fase": {
"type": "string",
"description": "Original phase publication timestamp from fecha_de_publicacion_fase. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"fecha_de_publicacion_fase_1": {
"type": "string",
"description": "Original phase publication timestamp from fecha_de_publicacion_fase_1; suffix does not establish phase order. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"fecha_de_publicacion_raw": {
"type": "string",
"description": "Separate original fecha_de_publicacion timestamp; not an alias of fecha_de_publicacion_del. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"fecha_de_publicacion_fase_2": {
"type": "string",
"description": "Original phase publication timestamp from fecha_de_publicacion_fase_2; suffix does not establish phase order. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"fecha_de_publicacion_fase_3": {
"type": "string",
"description": "Original phase publication timestamp from fecha_de_publicacion_fase_3; suffix does not establish phase order. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"precio_base": {
"type": "string",
"description": "Original procurement base price, without scaling or currency conversion. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"modalidad_de_contratacion": {
"type": "string",
"description": "Published process procurement-method label.",
"x-latinfo-meaning": "text"
},
"justificacion_modalidad_de": {
"type": "string",
"description": "Published justification for the process procurement method.",
"x-latinfo-meaning": "text"
},
"duracion": {
"type": "string",
"description": "Original process duration; interpret only with unidad_de_duracion. Unit: publisher unit in unidad_de_duracion.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "publisher unit in unidad_de_duracion"
},
"unidad_de_duracion": {
"type": "string",
"description": "Publisher unit label for duracion, preserved without conversion.",
"x-latinfo-meaning": "text"
},
"fecha_de_recepcion_de": {
"type": "string",
"description": "Original receipt timestamp from fecha_de_recepcion_de; the importer does not infer the truncated field's event semantics. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"fecha_de_apertura_de_respuesta": {
"type": "string",
"description": "Original response-opening timestamp. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"fecha_de_apertura_efectiva": {
"type": "string",
"description": "Original actual-opening timestamp. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"ciudad_de_la_unidad_de": {
"type": "string",
"description": "City of the procurement unit as published.",
"x-latinfo-meaning": "text"
},
"nombre_de_la_unidad_de": {
"type": "string",
"description": "Procurement unit name as published.",
"x-latinfo-meaning": "text"
},
"proveedores_invitados": {
"type": "string",
"description": "Published count of invited providers. Unit: count.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "count"
},
"proveedores_con_invitacion": {
"type": "string",
"description": "Original count from proveedores_con_invitacion; not the derived corporate bidder_count. Unit: count.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "count"
},
"visualizaciones_del": {
"type": "string",
"description": "Published process-view count. Unit: count.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "count"
},
"proveedores_que_manifestaron": {
"type": "string",
"description": "Original provider-interest count from proveedores_que_manifestaron. Unit: count.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "count"
},
"respuestas_al_procedimiento": {
"type": "string",
"description": "Published procedure-response count. Unit: count.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "count"
},
"respuestas_externas": {
"type": "string",
"description": "Published external-response count. Unit: count.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "count"
},
"conteo_de_respuestas_a_ofertas": {
"type": "string",
"description": "Original offer-response count from conteo_de_respuestas_a_ofertas. Unit: count.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "count"
},
"proveedores_unicos_con": {
"type": "string",
"description": "Original unique-provider count from proveedores_unicos_con; no inferred award status. Unit: count.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "count"
},
"numero_de_lotes": {
"type": "string",
"description": "Published number of procurement lots. Unit: count.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "count"
},
"estado_del_procedimiento": {
"type": "string",
"description": "Original process status; not a company compliance or tax status.",
"x-latinfo-meaning": "text"
},
"id_estado_del_procedimiento": {
"type": "string",
"description": "Publisher code for the process status.",
"x-latinfo-meaning": "code"
},
"adjudicado": {
"type": "string",
"description": "Original award indicator; preserve the publisher's string value.",
"x-latinfo-meaning": "text"
},
"id_adjudicacion": {
"type": "string",
"description": "Original award identifier.",
"x-latinfo-meaning": "identifier"
},
"codigoproveedor": {
"type": "string",
"description": "Publisher awardee provider code from the process record.",
"x-latinfo-meaning": "code"
},
"departamento_proveedor": {
"type": "string",
"description": "Published awardee department, independent of conditional name/document redaction.",
"x-latinfo-meaning": "text"
},
"ciudad_proveedor": {
"type": "string",
"description": "Published awardee city, independent of conditional name/document redaction.",
"x-latinfo-meaning": "text"
},
"fecha_adjudicacion": {
"type": "string",
"description": "Published award timestamp. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"valor_total_adjudicacion": {
"type": "string",
"description": "Original total awarded amount, without scaling or currency conversion. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"nombre_proveedor_adjudicado": {
"type": "string",
"description": "Awardee name retained only when the reviewed corporate-NIT predicate passes; otherwise empty.",
"x-latinfo-meaning": "text"
},
"nit_proveedor_adjudicado": {
"type": "string",
"description": "Original awardee NIT retained only when the reviewed corporate-NIT predicate passes; otherwise empty.",
"x-latinfo-meaning": "identifier"
},
"codigo_categoria_unspsc": {
"type": "string",
"description": "Original main UNSPSC procurement category code.",
"x-latinfo-meaning": "code"
},
"estado_de_apertura_del_proceso": {
"type": "string",
"description": "Published process-opening status.",
"x-latinfo-meaning": "text"
},
"tipo_de_contrato": {
"type": "string",
"description": "Contract-type label in the process dataset; distinct from contrato_tipo_de_contrato.",
"x-latinfo-meaning": "text"
},
"subtipo_de_contrato": {
"type": "string",
"description": "Contract-subtype label in the process dataset.",
"x-latinfo-meaning": "text"
},
"categorias_adicionales": {
"type": "string",
"description": "Additional procurement categories as published; no inferred taxonomy expansion.",
"x-latinfo-meaning": "text"
},
"url_proceso": {
"type": "string",
"description": "Original official process URL; object-shaped Socrata URLs are reduced to their url value.",
"x-latinfo-meaning": "text"
},
"codigo_entidad": {
"type": "string",
"description": "Publisher buying-entity code from the process dataset.",
"x-latinfo-meaning": "code"
},
"estado_resumen": {
"type": "string",
"description": "Publisher summary-status label.",
"x-latinfo-meaning": "text"
},
"bidder_count": {
"type": "string",
"description": "Derived count of distinct bidder NITs passing the reviewed corporate-NIT predicate; excludes natural-person and malformed identifiers. Unit: count.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "count"
},
"contract_id": {
"type": "string",
"description": "Identifier of the single joined contract selected for the portfolio; not an exhaustive contract list.",
"x-latinfo-meaning": "identifier"
},
"contract_estado": {
"type": "string",
"description": "Published status of the single joined contract.",
"x-latinfo-meaning": "text"
},
"nombre_entidad": {
"type": "string",
"description": "Buying entity name from the joined contract record.",
"x-latinfo-meaning": "text"
},
"contrato_nit_entidad": {
"type": "string",
"description": "Original buying entity NIT from the joined contract record.",
"x-latinfo-meaning": "identifier"
},
"departamento": {
"type": "string",
"description": "Buying entity department from the joined contract record.",
"x-latinfo-meaning": "text"
},
"ciudad": {
"type": "string",
"description": "Buying entity city from the joined contract record.",
"x-latinfo-meaning": "text"
},
"localizacion": {
"type": "string",
"description": "Original contract location label from localizaci_n.",
"x-latinfo-meaning": "text"
},
"orden": {
"type": "string",
"description": "Original administrative-order label from the joined contract.",
"x-latinfo-meaning": "text"
},
"sector": {
"type": "string",
"description": "Original buying-entity sector label from the joined contract.",
"x-latinfo-meaning": "text"
},
"rama": {
"type": "string",
"description": "Original buying-entity branch label from the joined contract.",
"x-latinfo-meaning": "text"
},
"entidad_centralizada": {
"type": "string",
"description": "Original centralized-entity indicator; preserve its publisher string.",
"x-latinfo-meaning": "text"
},
"referencia_del_contrato": {
"type": "string",
"description": "Buying entity's original contract reference.",
"x-latinfo-meaning": "identifier"
},
"codigo_de_categoria_principal": {
"type": "string",
"description": "Main procurement category code from the joined contract.",
"x-latinfo-meaning": "code"
},
"descripcion_del_proceso": {
"type": "string",
"description": "Contract dataset's process description with identified natural-person provider names redacted.",
"x-latinfo-meaning": "text"
},
"contrato_tipo_de_contrato": {
"type": "string",
"description": "Contract-type label from the joined contract; distinct from the process value.",
"x-latinfo-meaning": "text"
},
"contrato_modalidad_de_contratacion": {
"type": "string",
"description": "Procurement-method label from the joined contract.",
"x-latinfo-meaning": "text"
},
"contrato_justificacion_modalidad_de": {
"type": "string",
"description": "Procurement-method justification from the joined contract.",
"x-latinfo-meaning": "text"
},
"fecha_de_firma": {
"type": "string",
"description": "Published signature timestamp for the joined contract. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"fecha_de_inicio_del_contrato": {
"type": "string",
"description": "Published contract-start timestamp. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"fecha_de_fin_del_contrato": {
"type": "string",
"description": "Published contract-end timestamp. Format: ISO 8601 source datetime.",
"x-latinfo-meaning": "datetime"
},
"condiciones_de_entrega": {
"type": "string",
"description": "Original contractual delivery-condition text.",
"x-latinfo-meaning": "text"
},
"tipodocproveedor": {
"type": "string",
"description": "Contractor document-type label retained only for a contractor with type NIT and a corporate-shaped number; otherwise empty.",
"x-latinfo-meaning": "text"
},
"documento_proveedor": {
"type": "string",
"description": "Original contractor document retained only when the reviewed corporate-NIT predicate passes; otherwise empty.",
"x-latinfo-meaning": "identifier"
},
"proveedor_adjudicado": {
"type": "string",
"description": "Contractor name retained only when the reviewed corporate-NIT predicate passes; otherwise empty.",
"x-latinfo-meaning": "text"
},
"es_grupo": {
"type": "string",
"description": "Original supplier-group indicator; no corporate ownership inference.",
"x-latinfo-meaning": "text"
},
"es_pyme": {
"type": "string",
"description": "Original supplier SME indicator; no independent size verification.",
"x-latinfo-meaning": "text"
},
"habilita_pago_adelantado": {
"type": "string",
"description": "Publisher advance-payment-enabled indicator.",
"x-latinfo-meaning": "text"
},
"liquidacion": {
"type": "string",
"description": "Publisher contract-liquidation indicator.",
"x-latinfo-meaning": "text"
},
"obligacion_ambiental": {
"type": "string",
"description": "Publisher environmental-obligation indicator; not evidence of compliance.",
"x-latinfo-meaning": "text"
},
"obligaciones_postconsumo": {
"type": "string",
"description": "Publisher post-consumer-obligation indicator; not evidence of compliance.",
"x-latinfo-meaning": "text"
},
"reversion": {
"type": "string",
"description": "Publisher reversion indicator.",
"x-latinfo-meaning": "text"
},
"origen_de_los_recursos": {
"type": "string",
"description": "Original contract resource-origin label.",
"x-latinfo-meaning": "text"
},
"destino_gasto": {
"type": "string",
"description": "Original contract expenditure-destination label.",
"x-latinfo-meaning": "text"
},
"valor_del_contrato": {
"type": "string",
"description": "Original total contract value, without scaling or currency conversion. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"valor_de_pago_adelantado": {
"type": "string",
"description": "Original contractual advance-payment value. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"valor_facturado": {
"type": "string",
"description": "Original invoiced contract amount. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"valor_pendiente_de_pago": {
"type": "string",
"description": "Original contract amount pending payment. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"valor_pagado": {
"type": "string",
"description": "Original paid contract amount. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"valor_amortizado": {
"type": "string",
"description": "Original amortized contract amount. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"valor_pendiente_de": {
"type": "string",
"description": "Original amount from valor_pendiente_de; its truncated name must not be interpreted as valor_pendiente_de_pago or valor_pendiente_de_ejecucion. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"valor_pendiente_de_ejecucion": {
"type": "string",
"description": "Original contract amount pending execution. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"saldo_cdp": {
"type": "string",
"description": "Original CDP balance; no inferred budget availability or eligibility. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"saldo_vigencia": {
"type": "string",
"description": "Original balance for the reporting fiscal period. Unit: COP.",
"x-latinfo-meaning": "amount",
"x-latinfo-unit": "COP"
},
"espostconflicto": {
"type": "string",
"description": "Publisher post-conflict indicator.",
"x-latinfo-meaning": "text"
},
"dias_adicionados": {
"type": "string",
"description": "Original number of days added to the contract. Unit: days.",
"x-latinfo-meaning": "quantity",
"x-latinfo-unit": "days"
},
"puntos_del_acuerdo": {
"type": "string",
"description": "Publisher agreement-points value; retained without interpreting its classification.",
"x-latinfo-meaning": "text"
},
"pilares_del_acuerdo": {
"type": "string",
"description": "Publisher agreement-pillars value; retained without interpreting its classification.",
"x-latinfo-meaning": "text"
},
"contrato_url": {
"type": "string",
"description": "Official URL from the joined contract record; Socrata URL objects are reduced to url.",
"x-latinfo-meaning": "text"
},
"presupuesto_general_de_la_nacion_pgn": {
"type": "string",
"description": "Original national-budget funding indicator; not an amount or percentage.",
"x-latinfo-meaning": "text"
},
"sistema_general_de_participaciones": {
"type": "string",
"description": "Original general participation-system funding indicator; not an amount or percentage.",
"x-latinfo-meaning": "text"
},
"sistema_general_de_regalias": {
"type": "string",
"description": "Original general royalty-system funding indicator; not an amount or percentage.",
"x-latinfo-meaning": "text"
},
"recursos_propios_alcaldias_gobernaciones_y_resguardos_indigenas": {
"type": "string",
"description": "Original own-resource funding indicator for local authorities and indigenous reservations; not an amount or percentage.",
"x-latinfo-meaning": "text"
},
"recursos_de_credito": {
"type": "string",
"description": "Original credit-resource funding indicator; not an amount or percentage.",
"x-latinfo-meaning": "text"
},
"recursos_propios": {
"type": "string",
"description": "Original own-resource funding indicator; not an amount or percentage.",
"x-latinfo-meaning": "text"
},
"contrato_codigo_entidad": {
"type": "string",
"description": "Buying-entity code from the joined contract.",
"x-latinfo-meaning": "code"
},
"codigo_proveedor": {
"type": "string",
"description": "Supplier code from the joined contract.",
"x-latinfo-meaning": "code"
},
"objeto_del_contrato": {
"type": "string",
"description": "Original contract object with identified natural-person provider names redacted.",
"x-latinfo-meaning": "text"
},
"duracion_del_contrato": {
"type": "string",
"description": "Original contract-duration text, including any publisher unit; no numeric duration is inferred.",
"x-latinfo-meaning": "text"
},
"el_contrato_puede_ser_prorrogado": {
"type": "string",
"description": "Publisher contract-extension indicator; no legal interpretation.",
"x-latinfo-meaning": "text"
},
"documentos_tipo": {
"type": "string",
"description": "Publisher standard-document indicator.",
"x-latinfo-meaning": "text"
},
"descripcion_documentos_tipo": {
"type": "string",
"description": "Publisher standard-document description.",
"x-latinfo-meaning": "text"
},
"direccion_de_ejecucion_del_contrato": {
"type": "string",
"description": "Contract execution address retained only for a corporate contractor; otherwise empty. This is not the company's registered address.",
"x-latinfo-meaning": "text"
},
"source_system": {
"type": "string",
"description": "Fixed SECOP_II provenance marker added by the importer.",
"x-latinfo-meaning": "text"
},
"search_blob": {
"type": "string",
"description": "Search text assembled from redacted process title, description and buying entity, capped at 2000 characters; not the complete original document.",
"x-latinfo-meaning": "text"
}
},
"required": [
"process_id",
"entidad",
"nit_entidad",
"departamento_entidad",
"ciudad_entidad",
"ordenentidad",
"codigo_pci",
"referencia_del_proceso",
"ppi",
"id_del_portafolio",
"nombre_del_procedimiento",
"descripcion_del_procedimiento",
"fase",
"fecha_de_publicacion",
"fecha_de_ultima_publicaci",
"fecha_de_publicacion_fase",
"fecha_de_publicacion_fase_1",
"fecha_de_publicacion_raw",
"fecha_de_publicacion_fase_2",
"fecha_de_publicacion_fase_3",
"precio_base",
"modalidad_de_contratacion",
"justificacion_modalidad_de",
"duracion",
"unidad_de_duracion",
"fecha_de_recepcion_de",
"fecha_de_apertura_de_respuesta",
"fecha_de_apertura_efectiva",
"ciudad_de_la_unidad_de",
"nombre_de_la_unidad_de",
"proveedores_invitados",
"proveedores_con_invitacion",
"visualizaciones_del",
"proveedores_que_manifestaron",
"respuestas_al_procedimiento",
"respuestas_externas",
"conteo_de_respuestas_a_ofertas",
"proveedores_unicos_con",
"numero_de_lotes",
"estado_del_procedimiento",
"id_estado_del_procedimiento",
"adjudicado",
"id_adjudicacion",
"codigoproveedor",
"departamento_proveedor",
"ciudad_proveedor",
"fecha_adjudicacion",
"valor_total_adjudicacion",
"nombre_proveedor_adjudicado",
"nit_proveedor_adjudicado",
"codigo_categoria_unspsc",
"estado_de_apertura_del_proceso",
"tipo_de_contrato",
"subtipo_de_contrato",
"categorias_adicionales",
"url_proceso",
"codigo_entidad",
"estado_resumen",
"bidder_count",
"contract_id",
"contract_estado",
"nombre_entidad",
"contrato_nit_entidad",
"departamento",
"ciudad",
"localizacion",
"orden",
"sector",
"rama",
"entidad_centralizada",
"referencia_del_contrato",
"codigo_de_categoria_principal",
"descripcion_del_proceso",
"contrato_tipo_de_contrato",
"contrato_modalidad_de_contratacion",
"contrato_justificacion_modalidad_de",
"fecha_de_firma",
"fecha_de_inicio_del_contrato",
"fecha_de_fin_del_contrato",
"condiciones_de_entrega",
"tipodocproveedor",
"documento_proveedor",
"proveedor_adjudicado",
"es_grupo",
"es_pyme",
"habilita_pago_adelantado",
"liquidacion",
"obligacion_ambiental",
"obligaciones_postconsumo",
"reversion",
"origen_de_los_recursos",
"destino_gasto",
"valor_del_contrato",
"valor_de_pago_adelantado",
"valor_facturado",
"valor_pendiente_de_pago",
"valor_pagado",
"valor_amortizado",
"valor_pendiente_de",
"valor_pendiente_de_ejecucion",
"saldo_cdp",
"saldo_vigencia",
"espostconflicto",
"dias_adicionados",
"puntos_del_acuerdo",
"pilares_del_acuerdo",
"contrato_url",
"presupuesto_general_de_la_nacion_pgn",
"sistema_general_de_participaciones",
"sistema_general_de_regalias",
"recursos_propios_alcaldias_gobernaciones_y_resguardos_indigenas",
"recursos_de_credito",
"recursos_propios",
"contrato_codigo_entidad",
"codigo_proveedor",
"objeto_del_contrato",
"duracion_del_contrato",
"el_contrato_puede_ser_prorrogado",
"documentos_tipo",
"descripcion_documentos_tipo",
"direccion_de_ejecucion_del_contrato",
"source_system",
"search_blob"
],
"additionalProperties": false
}400Invalid identifier or query. Correct the input before retrying.
401Missing or invalid API key. Authenticate before retrying.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
503Source unavailable. Report unavailable, not an empty result.
Example JSON
Illustrative schema example. This is not a live response.
{
"process_id": "string",
"entidad": "string",
"nit_entidad": "string",
"departamento_entidad": "string",
"ciudad_entidad": "string",
"ordenentidad": "string",
"codigo_pci": "string",
"referencia_del_proceso": "string",
"ppi": "string",
"id_del_portafolio": "string",
"nombre_del_procedimiento": "string",
"descripcion_del_procedimiento": "string",
"fase": "string",
"fecha_de_publicacion": "string",
"fecha_de_ultima_publicaci": "string",
"fecha_de_publicacion_fase": "string",
"fecha_de_publicacion_fase_1": "string",
"fecha_de_publicacion_raw": "string"
}Provenance and limitations
Coverage varies by country and public source. A missing field is not evidence that the underlying fact does not exist. Public registries may be delayed or contain source errors; inspect the returned evidence and source date before relying on a result.