---
title: "SECOP Contracts by Provider"
method: POST
path: "/co/secop/contracts-by-provider/v1"
tags: ["Colombia", "SECOP"]
deprecated: true
---

# SECOP Contracts by Provider

`POST /co/secop/contracts-by-provider/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/secop/contracts-by-provider/v1`
- Auth: HTTP bearer

> **Deprecated.**

Deprecated since 2026-08-30; stops answering on 2026-12-01. Use `POST /co/secop/contracts-search/v1` instead.

List the public-procurement contracts (SECOP II) awarded to one provider by cédula or NIT, across all contracting entities: the contractor profile (who hired them, values, status, dates). Optional filters: contracting-entity NIT and a sign-date window (`from_date`/`to_date`). Pages of 500, newest first (`page`, 1-based); `capped: true` means the page is full and later pages may exist.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `document_number` string, required: Provider cédula or NIT. Dots and a trailing verification digit are optional: `900195855`, `900195855-1` and `900.195.855-1` all match the same contractor.
  - `entity_nit` string: Optional contracting-entity NIT filter (digits, no verification digit).
  - `from_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `to_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `page` integer: 1-based page number for paginated results.

## Response `200`

Successful response

- SecopContractSearchResponse
  - `data` SecopContractSearchData, required
    - `document_number` string, required: Echoes the request's `document_number` (the provider cédula/NIT).
    - `entity_nit` string, nullable, required
    - `from_date` string, nullable, required
    - `to_date` string, nullable, required
    - `count` number, required: Returned count for this page.
    - `capped` boolean, required: True when this page is full; later pages may exist.
    - `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
    - `pagination` object, required
      - `total` number, required
      - `page_size` number, required
      - `total_pages` number, required
      - `page` number, required
  - `deprecation` object: Present only while this endpoint is being retired. Mirrors the Deprecation, Sunset and Link response headers.
    - `since` string, date, required
    - `sunset` string, date, required
    - `successor` string, required: Path of the endpoint to use instead.
    - `message` string, 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)