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.
Authorizations
Use Authorization: Bearer YOUR_API_KEY
Headers
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.
255"0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b"
Body
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.
^[0-9A-Za-z.\-]{4,24}$Optional contracting-entity NIT filter (digits, no verification digit).
^(\d{4,15})?$Optional date filter in yyyy-mm-dd format.
Optional date filter in yyyy-mm-dd format.
1-based page number for paginated results.
1 <= x <= 1000