SECOP Contracts by Provider

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.

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

Headers

Idempotency-Keystring

Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

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.

Request body

document_numberstring 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_nitstring

Optional contracting-entity NIT filter (digits, no verification digit).

from_datestring date

Optional date filter in yyyy-mm-dd format.

to_datestring date

Optional date filter in yyyy-mm-dd format.

pageinteger

1-based page number for paginated results.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.