--- title: "SECOP Process by Notice" method: POST path: "/co/secop/process/v1" tags: ["Colombia", "SECOP"] --- # SECOP Process by Notice `POST /co/secop/process/v1` ## Request - Base URL: `https://api.croma.run` - URL: `https://api.croma.run/co/secop/process/v1` - Auth: HTTP bearer Resolve a Colombian public-procurement process (SECOP II) by its OpportunityDetail noticeUID and return the process header, the per-provider award list, and every awarded contract: providers, documents, values, dates, and execution amounts. Sourced from Colombia Compra Eficiente's open data. `found: false` when no process matches the noticeUID. ## Headers - `Idempotency-Key` string ## Request body - object - `notice_uid` string, required: SECOP OpportunityDetail noticeUID, e.g. "CO1.NTC.9458505". ## Response `200` Successful response - SecopProcessResponse - `data` SecopProcessData, required - `found` boolean, required: Whether a process matched the noticeUID. When false, `process` is null. - `notice_uid` string, required - `process` object, nullable, required - `notice_uid` string, nullable, required - `process_id` string, nullable, required: Process id (CO1.REQ.*). - `portfolio_id` string, nullable, required: Portfolio id (CO1.BDOS.*); the join key to the awarded contracts. - `reference` string, nullable, required - `name` string, nullable, required - `description` string, nullable, required - `entity` string, nullable, required - `entity_nit` string, nullable, required - `entity_code` string, nullable, required - `entity_order` string, nullable, required - `entity_department` string, nullable, required - `entity_city` string, nullable, required - `procurement_unit` string, nullable, required - `procurement_unit_city` string, nullable, required - `modality` string, nullable, required - `modality_justification` string, nullable, required - `contract_type` string, nullable, required - `contract_subtype` string, nullable, required - `unspsc_code` string, nullable, required - `additional_categories` string, nullable, required - `duration` string, nullable, required - `duration_unit` string, nullable, required - `lots` number, nullable, required - `base_price` number, nullable, required - `phase` string, nullable, required - `status_summary` string, nullable, required - `procedure_status` string, nullable, required - `opening_status` string, nullable, required - `published_date` string, nullable, required - `last_published_date` string, nullable, required - `bid_deadline` string, nullable, required: Deadline for providers to submit offers (fecha de recepción de ofertas). - `awarded` boolean, nullable, required: From the process dataset; lags reality. Trust `contracts` for who won. - `awarded_value` number, nullable, required: Total adjudicated across every award of the process (a process can award many providers, e.g. framework agreements). - `award_count` number, nullable, required: Number of individual awards behind `awarded_value`; 0 when unawarded. - `award_date` string, nullable, required - `invited_providers` number, nullable, required - `directly_invited_providers` number, nullable, required - `interested_providers` number, nullable, required - `responses` number, nullable, required - `external_responses` number, nullable, required - `offer_responses` number, nullable, required - `unique_responding_providers` number, nullable, required - `views` number, nullable, required - `url` string, nullable, required - `awards` object[], required: Per-provider award rows. `process.awarded_value`/`award_count` stay authoritative beyond the cap. - `provider` string, nullable, required - `provider_nit` string, nullable, required - `provider_code` string, nullable, required - `provider_department` string, nullable, required - `provider_city` string, nullable, required - `awarded_value` number, nullable, required: This provider's slice of the process award. - `award_date` string, nullable, required - `awards_capped` boolean, required - `contract_count` number, required - `contracts_capped` boolean, required: True when the contracts join hit its cap and the list may be incomplete. - `contracts` object[], required - `contract_id` string, nullable, required - `reference` string, nullable, required - `entity` string, nullable, required - `entity_nit` string, nullable, required - `centralized_entity` string, nullable, required: "Centralizada" / "Descentralizada" (not a boolean upstream). - `provider` string, nullable, required - `provider_document` string, nullable, required - `provider_document_type` string, nullable, required - `provider_code` string, nullable, required - `is_sme` boolean, nullable, required - `is_group` boolean, nullable, required: True when the provider is a plural structure (consortium / unión temporal). - `legal_rep_name` string, nullable, required - `legal_rep_document_type` string, nullable, required - `legal_rep_document` string, nullable, required - `status` string, nullable, required - `contract_type` string, nullable, required - `modality` string, nullable, required: How the contract was procured (open tender, direct contracting, ...). - `modality_justification` string, nullable, required - `unspsc_code` string, nullable, required - `object` string, nullable, required - `delivery_conditions` string, nullable, required - `value` number, nullable, required - `invoiced_value` number, nullable, required - `paid_value` number, nullable, required - `pending_execution_value` number, nullable, required - `pending_payment_value` number, nullable, required - `advance_payment_enabled` boolean, nullable, required - `advance_payment_value` number, nullable, required - `amortized_value` number, nullable, required - `pending_amortization_value` number, nullable, required - `sign_date` string, nullable, required - `start_date` string, nullable, required - `end_date` string, nullable, required - `added_days` number, nullable, required - `duration` string, nullable, required - `can_be_extended` boolean, nullable, required - `extension_notice_date` string, nullable, required: When the entity gave notice of an extension (prórroga). - `requires_liquidation` boolean, nullable, required: Whether the contract carries a liquidation stage at its end. - `liquidation_start_date` string, nullable, required - `liquidation_end_date` string, nullable, required - `has_environmental_obligation` boolean, nullable, required - `has_post_consumption_obligations` boolean, nullable, required - `has_reversion` boolean, nullable, required - `location` string, nullable, required - `supervisor` string, nullable, required - `expense_orderer` string, nullable, required - `funding_origin` string, nullable, required - `expense_destination` string, nullable, required: "Inversión" or "Funcionamiento". - `sector` string, nullable, required - `branch` string, nullable, required - `updated_date` string, nullable, required - `url` string, nullable, required ## Other responses - `400`: Invalid request body - `401`: Missing or invalid API key - `429`: Rate limit exceeded - `500`: Internal error - `502`: Upstream source returned an error --- [API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)