Colombia · co_cce_secop_procurement_process_id
OpenAPI

Lookup cce · secop-procurement by PROCESS_ID

GET 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.

Machine-readable source contract · Source documentation

Authentication required. REST requests use a Latinfo API key. The interactive console builds the authorization header and does not store the key.

Parameters

process_idstringpathrequired

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.

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-At

Import time, not the date of the government observation.

X-Source-Updated-At

Publisher update time, when known.

X-Latest-Observation-At

Latest 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-Status

string

CURRENT · DELAYED · STALE · UNKNOWN
X-Credits-Cost

Actual credits charged for this request.

X-Source-Generation

Opaque immutable source generation. Follow the guarded next-page Link when collecting a history.

Content-Type: application/json

Response fields

process_id string required

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 string required

Public buying entity name from the process record.

nit_entidad string required

Buying entity NIT exactly as published; keep leading zeros and punctuation.

departamento_entidad string required

Department of the buying entity in the process record.

ciudad_entidad string required

City of the buying entity in the process record.

ordenentidad string required

Publisher administrative-order label for the buying entity.

codigo_pci string required

Publisher PCI code for the buying entity; no inferred classification.

referencia_del_proceso string required

Buying entity's original process reference.

ppi string required

Original PPI value from the process dataset; no expansion or inferred meaning.

id_del_portafolio string required

SECOP portfolio identifier (BDOS namespace), used to join contracts; distinct from the REQ process identifier.

nombre_del_procedimiento string required

Published process title with identified natural-person provider names redacted.

descripcion_del_procedimiento string required

Published process description with identified natural-person provider names redacted.

fase string required

Original procurement phase label.

fecha_de_publicacion string required

Process publication timestamp from fecha_de_publicacion_del; distinct from import time. Format: ISO 8601 source datetime.

fecha_de_ultima_publicaci string required

Publisher's last process publication timestamp; not the Latinfo import time. Format: ISO 8601 source datetime.

fecha_de_publicacion_fase string required

Original phase publication timestamp from fecha_de_publicacion_fase. Format: ISO 8601 source datetime.

fecha_de_publicacion_fase_1 string required

Original 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 required

Separate original fecha_de_publicacion timestamp; not an alias of fecha_de_publicacion_del. Format: ISO 8601 source datetime.

fecha_de_publicacion_fase_2 string required

Original 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 required

Original phase publication timestamp from fecha_de_publicacion_fase_3; suffix does not establish phase order. Format: ISO 8601 source datetime.

precio_base string required

Original procurement base price, without scaling or currency conversion. Unit: COP.

COP

modalidad_de_contratacion string required

Published process procurement-method label.

justificacion_modalidad_de string required

Published justification for the process procurement method.

duracion string required

Original 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 required

Publisher unit label for duracion, preserved without conversion.

fecha_de_recepcion_de string required

Original 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 required

Original response-opening timestamp. Format: ISO 8601 source datetime.

fecha_de_apertura_efectiva string required

Original actual-opening timestamp. Format: ISO 8601 source datetime.

ciudad_de_la_unidad_de string required

City of the procurement unit as published.

nombre_de_la_unidad_de string required

Procurement unit name as published.

proveedores_invitados string required

Published count of invited providers. Unit: count.

count

proveedores_con_invitacion string required

Original count from proveedores_con_invitacion; not the derived corporate bidder_count. Unit: count.

count

visualizaciones_del string required

Published process-view count. Unit: count.

count

proveedores_que_manifestaron string required

Original provider-interest count from proveedores_que_manifestaron. Unit: count.

count

respuestas_al_procedimiento string required

Published procedure-response count. Unit: count.

count

respuestas_externas string required

Published external-response count. Unit: count.

count

conteo_de_respuestas_a_ofertas string required

Original offer-response count from conteo_de_respuestas_a_ofertas. Unit: count.

count

proveedores_unicos_con string required

Original unique-provider count from proveedores_unicos_con; no inferred award status. Unit: count.

count

numero_de_lotes string required

Published number of procurement lots. Unit: count.

count

estado_del_procedimiento string required

Original process status; not a company compliance or tax status.

id_estado_del_procedimiento string required

Publisher code for the process status.

adjudicado string required

Original award indicator; preserve the publisher's string value.

id_adjudicacion string required

Original award identifier.

codigoproveedor string required

Publisher awardee provider code from the process record.

departamento_proveedor string required

Published awardee department, independent of conditional name/document redaction.

ciudad_proveedor string required

Published awardee city, independent of conditional name/document redaction.

fecha_adjudicacion string required

Published award timestamp. Format: ISO 8601 source datetime.

valor_total_adjudicacion string required

Original total awarded amount, without scaling or currency conversion. Unit: COP.

COP

nombre_proveedor_adjudicado string required

Awardee name retained only when the reviewed corporate-NIT predicate passes; otherwise empty.

nit_proveedor_adjudicado string required

Original awardee NIT retained only when the reviewed corporate-NIT predicate passes; otherwise empty.

codigo_categoria_unspsc string required

Original main UNSPSC procurement category code.

estado_de_apertura_del_proceso string required

Published process-opening status.

tipo_de_contrato string required

Contract-type label in the process dataset; distinct from contrato_tipo_de_contrato.

subtipo_de_contrato string required

Contract-subtype label in the process dataset.

categorias_adicionales string required

Additional procurement categories as published; no inferred taxonomy expansion.

url_proceso string required

Original official process URL; object-shaped Socrata URLs are reduced to their url value.

codigo_entidad string required

Publisher buying-entity code from the process dataset.

estado_resumen string required

Publisher summary-status label.

bidder_count string required

Derived count of distinct bidder NITs passing the reviewed corporate-NIT predicate; excludes natural-person and malformed identifiers. Unit: count.

count

contract_id string required

Identifier of the single joined contract selected for the portfolio; not an exhaustive contract list.

contract_estado string required

Published status of the single joined contract.

nombre_entidad string required

Buying entity name from the joined contract record.

contrato_nit_entidad string required

Original buying entity NIT from the joined contract record.

departamento string required

Buying entity department from the joined contract record.

ciudad string required

Buying entity city from the joined contract record.

localizacion string required

Original contract location label from localizaci_n.

orden string required

Original administrative-order label from the joined contract.

sector string required

Original buying-entity sector label from the joined contract.

rama string required

Original buying-entity branch label from the joined contract.

entidad_centralizada string required

Original centralized-entity indicator; preserve its publisher string.

referencia_del_contrato string required

Buying entity's original contract reference.

codigo_de_categoria_principal string required

Main procurement category code from the joined contract.

descripcion_del_proceso string required

Contract dataset's process description with identified natural-person provider names redacted.

contrato_tipo_de_contrato string required

Contract-type label from the joined contract; distinct from the process value.

contrato_modalidad_de_contratacion string required

Procurement-method label from the joined contract.

contrato_justificacion_modalidad_de string required

Procurement-method justification from the joined contract.

fecha_de_firma string required

Published signature timestamp for the joined contract. Format: ISO 8601 source datetime.

fecha_de_inicio_del_contrato string required

Published contract-start timestamp. Format: ISO 8601 source datetime.

fecha_de_fin_del_contrato string required

Published contract-end timestamp. Format: ISO 8601 source datetime.

condiciones_de_entrega string required

Original contractual delivery-condition text.

tipodocproveedor string required

Contractor document-type label retained only for a contractor with type NIT and a corporate-shaped number; otherwise empty.

documento_proveedor string required

Original contractor document retained only when the reviewed corporate-NIT predicate passes; otherwise empty.

proveedor_adjudicado string required

Contractor name retained only when the reviewed corporate-NIT predicate passes; otherwise empty.

es_grupo string required

Original supplier-group indicator; no corporate ownership inference.

es_pyme string required

Original supplier SME indicator; no independent size verification.

habilita_pago_adelantado string required

Publisher advance-payment-enabled indicator.

liquidacion string required

Publisher contract-liquidation indicator.

obligacion_ambiental string required

Publisher environmental-obligation indicator; not evidence of compliance.

obligaciones_postconsumo string required

Publisher post-consumer-obligation indicator; not evidence of compliance.

reversion string required

Publisher reversion indicator.

origen_de_los_recursos string required

Original contract resource-origin label.

destino_gasto string required

Original contract expenditure-destination label.

valor_del_contrato string required

Original total contract value, without scaling or currency conversion. Unit: COP.

COP

valor_de_pago_adelantado string required

Original contractual advance-payment value. Unit: COP.

COP

valor_facturado string required

Original invoiced contract amount. Unit: COP.

COP

valor_pendiente_de_pago string required

Original contract amount pending payment. Unit: COP.

COP

valor_pagado string required

Original paid contract amount. Unit: COP.

COP

valor_amortizado string required

Original amortized contract amount. Unit: COP.

COP

valor_pendiente_de string required

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.

COP

valor_pendiente_de_ejecucion string required

Original contract amount pending execution. Unit: COP.

COP

saldo_cdp string required

Original CDP balance; no inferred budget availability or eligibility. Unit: COP.

COP

saldo_vigencia string required

Original balance for the reporting fiscal period. Unit: COP.

COP

espostconflicto string required

Publisher post-conflict indicator.

dias_adicionados string required

Original number of days added to the contract. Unit: days.

days

puntos_del_acuerdo string required

Publisher agreement-points value; retained without interpreting its classification.

pilares_del_acuerdo string required

Publisher agreement-pillars value; retained without interpreting its classification.

contrato_url string required

Official URL from the joined contract record; Socrata URL objects are reduced to url.

presupuesto_general_de_la_nacion_pgn string required

Original national-budget funding indicator; not an amount or percentage.

sistema_general_de_participaciones string required

Original general participation-system funding indicator; not an amount or percentage.

sistema_general_de_regalias string required

Original general royalty-system funding indicator; not an amount or percentage.

recursos_propios_alcaldias_gobernaciones_y_resguardos_indigenas string required

Original own-resource funding indicator for local authorities and indigenous reservations; not an amount or percentage.

recursos_de_credito string required

Original credit-resource funding indicator; not an amount or percentage.

recursos_propios string required

Original own-resource funding indicator; not an amount or percentage.

contrato_codigo_entidad string required

Buying-entity code from the joined contract.

codigo_proveedor string required

Supplier code from the joined contract.

objeto_del_contrato string required

Original contract object with identified natural-person provider names redacted.

duracion_del_contrato string required

Original contract-duration text, including any publisher unit; no numeric duration is inferred.

el_contrato_puede_ser_prorrogado string required

Publisher contract-extension indicator; no legal interpretation.

documentos_tipo string required

Publisher standard-document indicator.

descripcion_documentos_tipo string required

Publisher standard-document description.

direccion_de_ejecucion_del_contrato string required

Contract execution address retained only for a corporate contractor; otherwise empty. This is not the company's registered address.

source_system string required

Fixed SECOP_II provenance marker added by the importer.

search_blob string required

Search 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.
No response body documented.
401Missing or invalid API key. Authenticate before retrying.
No response body documented.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
No response body documented.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
No response body documented.
503Source unavailable. Report unavailable, not an empty result.
No response body documented.
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.