SECOP Bidders Search

Search who bid on Colombian procurement processes, including the bidders that lost. Filter by process id or by a bidder's document to see either everyone who competed for one contract, or every process a company has bid on. This is the only published view of how contested a tender actually was.

Dataset endpoint: answers from the whole source in milliseconds and carries as_of.

post/co/secop/bidders-search/v1

Request

Base URL: https://api.croma.run
URL: https://api.croma.run/co/secop/bidders-search/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

process_idstring

Optional process id from a search result (id on a process, or process_id on a bidder). Empty searches every process.

bidder_documentstring

Optional document filter: a NIT or a cédula, with or without dots and verification digit (900195855, 900.195.855-1 and 900195855-1 all match the same records).

platform'any' | 'secop_i' | 'secop_ii'

Restrict to one system: secop_ii (the transactional platform, 2015 onward), secop_i (the publication register, 2004 onward), or any for both.

yearinteger

Optional calendar year. 0 searches every year.

pageinteger

1-based page number for paginated results.

per_pageinteger

Results per page (1-100).

Response

Successful response

Changes

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