> ## Documentation Index > Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt > Use this file to discover all available pages before exploring further. # SECOP Process by Notice > 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. ## OpenAPI ````yaml /api-reference/openapi.json post /co/secop/process/v1 openapi: 3.1.0 info: title: Croma Marketplace API version: 1.0.0 description: >- Government-data APIs for Colombia, Peru, Mexico, United States, Brazil, El Salvador, Bolivia, and Japan, plus global web search. Croma normalizes public-sector data into structured JSON for product teams and AI agents. Every operation is a POST with a JSON body and an organization API key as a bearer token; every operation is an idempotent lookup and accepts an optional `Idempotency-Key` header. Paths carry their major version (`/v1`); the versioning and deprecation policy, including the `Deprecation` and `Sunset` headers a retiring endpoint sends, is at https://docs.usecroma.com/versioning. Rate limits are per organization and reported on every response (`RateLimit-Policy`, `X-RateLimit-*`): https://docs.usecroma.com/rate-limits. termsOfService: https://usecroma.com/en/terms contact: name: Croma support url: https://usecroma.com/en/support email: support@usecroma.com servers: - url: https://api.croma.run security: [] paths: /co/secop/process/v1: post: tags: - Colombia - SECOP summary: SECOP Process by Notice description: >- 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. operationId: secop_process parameters: - $ref: '#/components/parameters/IdempotencyKey' requestBody: required: true content: application/json: schema: type: object required: - notice_uid properties: notice_uid: type: string pattern: ^CO1\.NTC\.\d{3,}$ description: SECOP OpportunityDetail noticeUID, e.g. "CO1.NTC.9458505". additionalProperties: false example: notice_uid: CO1.NTC.9458505 responses: '200': description: Successful response headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' X-Cache: $ref: '#/components/headers/X-Cache' content: application/json: schema: $ref: '#/components/schemas/SecopProcessResponse' '400': description: Invalid request body headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Missing or invalid API key headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: Rate limit exceeded headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/ApiError' '500': description: Internal error headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '502': description: Upstream source returned an error headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' security: - bearerAuth: [] externalDocs: description: Interactive documentation and examples url: https://docs.usecroma.com/guides/colombia/secop components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false description: >- Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the `Idempotency-Key` response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit. schema: type: string maxLength: 255 example: 0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b headers: X-Request-Id: description: Unique id for the request (req_…). Include it in support reports. schema: type: string RateLimit-Policy: description: >- Quota policy for this endpoint as an IETF RateLimit-Policy structured field, e.g. `"default";q=100;w=86400` (100 requests per 86400-second window per organization). Endpoints with an extra hourly ceiling list both policies, e.g. `"webSearch";q=100;w=3600, "default";q=100;w=86400`. Present on every response, including 401 and 429. schema: type: string example: '"default";q=100;w=86400' Idempotency-Key: description: >- The `Idempotency-Key` the request carried, echoed back unchanged. Absent when the request sent none. schema: type: string Deprecation: description: >- Present only on an endpoint version scheduled for removal: the date the deprecation took effect (RFC 9745). A `Sunset` header and a `Link` with `rel="successor-version"` accompany it. Policy: https://docs.usecroma.com/versioning schema: type: string example: '@1767225600' Sunset: description: >- Present only on an endpoint version scheduled for removal: the date after which it answers 410 (RFC 8594). Announced in the changelog at least 90 days ahead. schema: type: string format: date-time example: Wed, 01 Apr 2026 00:00:00 GMT X-RateLimit-Limit: description: Requests allowed in the current window. schema: type: integer X-RateLimit-Remaining: description: Requests left before you are throttled. schema: type: integer X-RateLimit-Reset: description: ISO 8601 timestamp when the window resets. schema: type: string format: date-time X-Cache: description: >- HIT or MISS. Cached hits spend no credits, but still count toward an hourly ceiling. schema: type: string enum: - HIT - MISS Retry-After: description: Seconds to wait before retrying. schema: type: integer schemas: SecopProcessResponse: type: object required: - data properties: data: $ref: '#/components/schemas/SecopProcessData' ApiError: type: object required: - error properties: error: type: object required: - type - code - message properties: type: type: string description: >- Broad category: invalid_request_error, authentication_error, not_found_error, rate_limit_error, upstream_error, api_error. code: type: string description: Machine-readable specific code. message: type: string description: Human-readable explanation, safe to surface in UI. param: type: string description: Field that triggered the error. Present on validation errors. details: type: object description: Free-form structured detail. SecopProcessData: type: object properties: found: type: boolean description: >- Whether a process matched the noticeUID. When false, `process` is null. notice_uid: type: string process: anyOf: - type: object properties: notice_uid: anyOf: - type: string - type: 'null' process_id: anyOf: - type: string - type: 'null' description: Process id (CO1.REQ.*). portfolio_id: anyOf: - type: string - type: 'null' description: >- Portfolio id (CO1.BDOS.*); the join key to the awarded contracts. reference: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' description: anyOf: - type: string - type: 'null' entity: anyOf: - type: string - type: 'null' entity_nit: anyOf: - type: string - type: 'null' entity_code: anyOf: - type: string - type: 'null' entity_order: anyOf: - type: string - type: 'null' entity_department: anyOf: - type: string - type: 'null' entity_city: anyOf: - type: string - type: 'null' procurement_unit: anyOf: - type: string - type: 'null' procurement_unit_city: anyOf: - type: string - type: 'null' modality: anyOf: - type: string - type: 'null' modality_justification: anyOf: - type: string - type: 'null' contract_type: anyOf: - type: string - type: 'null' contract_subtype: anyOf: - type: string - type: 'null' unspsc_code: anyOf: - type: string - type: 'null' additional_categories: anyOf: - type: string - type: 'null' duration: anyOf: - type: string - type: 'null' duration_unit: anyOf: - type: string - type: 'null' lots: anyOf: - type: number - type: 'null' base_price: anyOf: - type: number - type: 'null' phase: anyOf: - type: string - type: 'null' status_summary: anyOf: - type: string - type: 'null' procedure_status: anyOf: - type: string - type: 'null' opening_status: anyOf: - type: string - type: 'null' published_date: anyOf: - type: string - type: 'null' last_published_date: anyOf: - type: string - type: 'null' bid_deadline: anyOf: - type: string - type: 'null' description: >- Deadline for providers to submit offers (fecha de recepción de ofertas). awarded: anyOf: - type: boolean - type: 'null' description: >- From the process dataset; lags reality. Trust `contracts` for who won. awarded_value: anyOf: - type: number - type: 'null' description: >- Total adjudicated across every award of the process (a process can award many providers, e.g. framework agreements). award_count: anyOf: - type: number - type: 'null' description: >- Number of individual awards behind `awarded_value`; 0 when unawarded. award_date: anyOf: - type: string - type: 'null' invited_providers: anyOf: - type: number - type: 'null' directly_invited_providers: anyOf: - type: number - type: 'null' interested_providers: anyOf: - type: number - type: 'null' responses: anyOf: - type: number - type: 'null' external_responses: anyOf: - type: number - type: 'null' offer_responses: anyOf: - type: number - type: 'null' unique_responding_providers: anyOf: - type: number - type: 'null' views: anyOf: - type: number - type: 'null' url: anyOf: - type: string - type: 'null' required: - notice_uid - process_id - portfolio_id - reference - name - description - entity - entity_nit - entity_code - entity_order - entity_department - entity_city - procurement_unit - procurement_unit_city - modality - modality_justification - contract_type - contract_subtype - unspsc_code - additional_categories - duration - duration_unit - lots - base_price - phase - status_summary - procedure_status - opening_status - published_date - last_published_date - bid_deadline - awarded - awarded_value - award_count - award_date - invited_providers - directly_invited_providers - interested_providers - responses - external_responses - offer_responses - unique_responding_providers - views - url - type: 'null' awards: type: array items: type: object properties: provider: anyOf: - type: string - type: 'null' provider_nit: anyOf: - type: string - type: 'null' provider_code: anyOf: - type: string - type: 'null' provider_department: anyOf: - type: string - type: 'null' provider_city: anyOf: - type: string - type: 'null' awarded_value: anyOf: - type: number - type: 'null' description: This provider's slice of the process award. award_date: anyOf: - type: string - type: 'null' required: - provider - provider_nit - provider_code - provider_department - provider_city - awarded_value - award_date description: >- Per-provider award rows. `process.awarded_value`/`award_count` stay authoritative beyond the cap. awards_capped: type: boolean contract_count: type: number contracts_capped: type: boolean description: >- True when the contracts join hit its cap and the list may be incomplete. contracts: type: array items: type: object properties: contract_id: anyOf: - type: string - type: 'null' reference: anyOf: - type: string - type: 'null' entity: anyOf: - type: string - type: 'null' entity_nit: anyOf: - type: string - type: 'null' centralized_entity: anyOf: - type: string - type: 'null' description: '"Centralizada" / "Descentralizada" (not a boolean upstream).' provider: anyOf: - type: string - type: 'null' provider_document: anyOf: - type: string - type: 'null' provider_document_type: anyOf: - type: string - type: 'null' provider_code: anyOf: - type: string - type: 'null' is_sme: anyOf: - type: boolean - type: 'null' is_group: anyOf: - type: boolean - type: 'null' description: >- True when the provider is a plural structure (consortium / unión temporal). legal_rep_name: anyOf: - type: string - type: 'null' legal_rep_document_type: anyOf: - type: string - type: 'null' legal_rep_document: anyOf: - type: string - type: 'null' status: anyOf: - type: string - type: 'null' contract_type: anyOf: - type: string - type: 'null' modality: anyOf: - type: string - type: 'null' description: >- How the contract was procured (open tender, direct contracting, ...). modality_justification: anyOf: - type: string - type: 'null' unspsc_code: anyOf: - type: string - type: 'null' object: anyOf: - type: string - type: 'null' delivery_conditions: anyOf: - type: string - type: 'null' value: anyOf: - type: number - type: 'null' invoiced_value: anyOf: - type: number - type: 'null' paid_value: anyOf: - type: number - type: 'null' pending_execution_value: anyOf: - type: number - type: 'null' pending_payment_value: anyOf: - type: number - type: 'null' advance_payment_enabled: anyOf: - type: boolean - type: 'null' advance_payment_value: anyOf: - type: number - type: 'null' amortized_value: anyOf: - type: number - type: 'null' pending_amortization_value: anyOf: - type: number - type: 'null' sign_date: anyOf: - type: string - type: 'null' start_date: anyOf: - type: string - type: 'null' end_date: anyOf: - type: string - type: 'null' added_days: anyOf: - type: number - type: 'null' duration: anyOf: - type: string - type: 'null' can_be_extended: anyOf: - type: boolean - type: 'null' extension_notice_date: anyOf: - type: string - type: 'null' description: When the entity gave notice of an extension (prórroga). requires_liquidation: anyOf: - type: boolean - type: 'null' description: Whether the contract carries a liquidation stage at its end. liquidation_start_date: anyOf: - type: string - type: 'null' liquidation_end_date: anyOf: - type: string - type: 'null' has_environmental_obligation: anyOf: - type: boolean - type: 'null' has_post_consumption_obligations: anyOf: - type: boolean - type: 'null' has_reversion: anyOf: - type: boolean - type: 'null' location: anyOf: - type: string - type: 'null' supervisor: anyOf: - type: string - type: 'null' expense_orderer: anyOf: - type: string - type: 'null' funding_origin: anyOf: - type: string - type: 'null' expense_destination: anyOf: - type: string - type: 'null' description: '"Inversión" or "Funcionamiento".' sector: anyOf: - type: string - type: 'null' branch: anyOf: - type: string - type: 'null' updated_date: anyOf: - type: string - type: 'null' url: anyOf: - type: string - type: 'null' required: - contract_id - reference - entity - entity_nit - centralized_entity - provider - provider_document - provider_document_type - provider_code - is_sme - is_group - legal_rep_name - legal_rep_document_type - legal_rep_document - status - contract_type - modality - modality_justification - unspsc_code - object - delivery_conditions - value - invoiced_value - paid_value - pending_execution_value - pending_payment_value - advance_payment_enabled - advance_payment_value - amortized_value - pending_amortization_value - sign_date - start_date - end_date - added_days - duration - can_be_extended - extension_notice_date - requires_liquidation - liquidation_start_date - liquidation_end_date - has_environmental_obligation - has_post_consumption_obligations - has_reversion - location - supervisor - expense_orderer - funding_origin - expense_destination - sector - branch - updated_date - url required: - found - notice_uid - process - awards - awards_capped - contract_count - contracts_capped - contracts securitySchemes: bearerAuth: type: http scheme: bearer description: 'Use Authorization: Bearer YOUR_API_KEY' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.