--- title: "SECOP Profile" method: POST path: "/co/secop/profile/v1" tags: ["Colombia", "SECOP"] --- # SECOP Profile `POST /co/secop/profile/v1` ## Request - Base URL: `https://api.croma.run` - URL: `https://api.croma.run/co/secop/profile/v1` - Auth: HTTP bearer Everything Colombian public procurement knows about one NIT or cédula, in a single call: the SECOP II supplier account if there is one, how many contracts it has signed and the largest of them, how many awards it has won, how many processes it has bid on, every sanction against it, and, when the document belongs to a public entity, what it has bought. Start here for any question about a company or a person; the searches are for paging past what this returns. **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. ## Headers - `Idempotency-Key` string ## Request body - object - `document` 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. - `per_section` integer: How many records each list in the response holds (1-25). The counts beside the lists are exact totals regardless of this. ## Response `200` Successful response - SecopProfileResponse - `data` SecopProfileData, required - `as_of` string, nullable, required: How current the data is: the moment these datasets were last brought up to date. - `document` string, required: The document as it was matched, digits only, no verification digit. - `found` boolean, required: Whether the corpus holds anything at all for this document. False means no contracts, awards, bids, sanctions or supplier account. - `supplier` object, nullable, required: The SECOP II supplier account, when the document has one. Null for a contractor that never registered, which is common on SECOP I. - `id` string, required: Stable identifier, `secop_ii:`. - `code` string, nullable, required: The supplier's own SECOP II code. - `name` string, nullable, required: Name or razón social of the supplier. - `document` string, nullable, required: NIT or cédula of the supplier, digits only, no verification digit. - `is_entity` boolean, nullable, required: True when the account belongs to a state entity rather than a vendor. - `is_group` boolean, nullable, required: True when the account is a consorcio or unión temporal. - `is_sme` boolean, nullable, required: True when the supplier is registered as a PyME. - `is_active` boolean, nullable, required: Whether the account is currently active. - `company_type` string, nullable, required: Tipo de empresa as the platform classifies it. - `unspsc_code` string, nullable, required: Main UNSPSC category the supplier registered under. - `unspsc_description` string, nullable, required: Description of that main category. - `country` string, nullable, required: Country of the supplier. - `department` string, nullable, required: Department of the supplier. - `city` string, nullable, required: Municipality of the supplier. - `address` string, nullable, required: Registered address. - `phone` string, nullable, required: Registered telephone. - `email` string, nullable, required: Registered contact email. - `website` string, nullable, required: Registered web site. - `legal_rep_name` string, nullable, required: Name of the legal representative. - `legal_rep_document` string, nullable, required: Document of the legal representative. - `legal_rep_document_type` string, nullable, required: Kind of document the legal representative holds. - `legal_rep_phone` string, nullable, required: Telephone of the legal representative. - `legal_rep_email` string, nullable, required: Email of the legal representative. - `registered_date` string, nullable, required: When the account was created, `yyyy-mm-dd`. - `year` number, nullable, required: Calendar year of `registered_date`. - `as_contractor` object, required: What this document has done as a seller to the state. - `contracts` number, required: Exact number of contracts signed, across both platforms. - `contracts_value` number, nullable, required: Summed value of `largest_contracts` only, in COP. Not a lifetime total; use `contracts` with the contracts search to page the rest. - `first_contract_date` string, nullable, required: Signature date of the earliest contract found. - `last_contract_date` string, nullable, required: Signature date of the most recent contract found. - `largest_contracts` object[], required: The largest contracts by value, newest first within equal values. - `id` string, required - `platform` string, required - `entity` string, nullable, required - `entity_nit` string, nullable, required - `object` string, nullable, required - `value_with_additions` number, nullable, required - `sign_date` string, nullable, required - `status` string, nullable, required - `awards` number, required: Exact number of awards won on SECOP II processes. - `largest_awards` object[], required: The largest awards by value. - `id` string, required - `process_id` string, nullable, required - `entity` string, nullable, required - `value` number, nullable, required - `awarded_at` string, nullable, required - `bids` number, required: Exact number of processes this document is recorded as having bid on. - `sanctions` number, required: Exact number of fines or sanctions imposed on this contractor. - `sanction_records` object[], required: The sanctions themselves; the register is small enough to return them. - `id` string, required: Stable identifier of the sanction. - `entity` string, nullable, required: Entity that imposed the sanction. - `entity_nit` string, nullable, required: NIT of that entity, digits only. - `entity_level` string, nullable, required: Nivel of the entity. - `entity_order` string, nullable, required: Orden of the entity. - `municipality` string, nullable, required: Municipality of the entity. - `resolution_number` string, nullable, required: Number of the resolution that imposed the sanction. - `provider` string, nullable, required: Name of the sanctioned contractor. - `provider_document` string, nullable, required: Document of the sanctioned contractor, digits only. - `contract_number` string, nullable, required: Contract the sanction was imposed under. - `value` number, nullable, required: Value of the sanction in COP. - `published_date` string, nullable, required: When the sanction was published, `yyyy-mm-dd`. - `final_date` string, nullable, required: When the sanction became final (fecha de firmeza), `yyyy-mm-dd`. - `year` number, nullable, required: Calendar year of `published_date`. - `url` string, nullable, required: Public page for the process the sanction belongs to. - `as_entity` object, required: What this document has done as a buyer. All zero for a document that is not a public entity. - `contracts` number, required: Exact number of contracts this entity has signed as the buyer. - `processes` number, required: Exact number of procurement processes this entity has published. - `largest_contracts` object[], required: The largest contracts this entity has signed, by value. - `id` string, required - `platform` string, required - `entity` string, nullable, required - `entity_nit` string, nullable, required - `object` string, nullable, required - `value_with_additions` number, nullable, required - `sign_date` string, nullable, required - `status` string, nullable, required ## Other responses - `400`: Invalid request body - `401`: Missing or invalid API key - `429`: Rate limit exceeded - `500`: Internal 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)