SECOP Processes by Entity

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

List the procurement processes (SECOP II) published by one contracting entity (by NIT), optionally within a publication-date window. The audit population for an entity. Returns lean summaries (drill into one with secop-process). Pages of 500, newest first (page, 1-based); capped: true means the page is full and later pages may exist.

post/co/secop/processes-by-entity/v1

Request

Base URL: https://api.croma.run
URL: https://api.croma.run/co/secop/processes-by-entity/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

Colombian NIT (numeric, no verification digit). 4-15 digits.

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.