Catalog / Company registries & public records
COMPANY REGISTRIES & PUBLIC RECORDS · COLOMBIA
Colombia Company Registry + Public Contract History
Look up Colombian companies in the national business registry (RUES on datos.gov.co) by NIT or company name: legal name, status, chamber of commerce, CIIU activity.
About this data
Look up Colombian companies in the national business registry (RUES on datos.gov.co) by NIT or company name: legal name, status, chamber of commerce, CIIU activity. Each company also gets its public contract history from SECOP II: award count, total value, top public buyers and latest award.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
2 endpoints at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
Colombia company lookup by NIT
POST /v1/co/nit
Every matrícula registered under a Colombian NIT from the national RUES extract (datos.gov.co): razón social, estado, cámara de comercio, CIIU activities and legal representative, optionally (enrichProcurement) with a best-effort SECOP II public-contract summary. Source: national RUES registry.
partial enrichment is flagged in summary.
Input
Send a JSON body to POST https://api.ssh.autos/v1/co/nit.
| Field | Type | Required | Notes |
|---|---|---|---|
nit | string | required | Colombian NIT, e.g. 890900608 (dots and a trailing check digit are tolerated). 5–20 characters |
enrichProcurement | boolean | optional | Also attach the company's SECOP II public-contract summary (best effort within the call's time budget; large suppliers often come back flagged unavailable). default false |
Returned fields
The answer is JSON: records, a list, and summary, the run status and counts. Each record has these 32 fields; a field the source does not publish comes back null.
32 fields per record
| Field | Type | Notes |
|---|---|---|
companyKey | string | Composite unique key: source:matricula:chamber:matricula (e.g. datos.gov.co:matricula:55:3190) — one NIT can carry matrículas in several chambers. |
nit | string | Company NIT without check digit (e.g. '890900608'). Null for legacy rows registered without identification. |
digitoVerificacion | string | Registry check digit (dígito de verificación), e.g. '9'. |
nitCompleto | string | Display form NIT-DV, e.g. '890900608-9'. |
razonSocial | string | Registered company name (razón social). |
sigla | string | Registered short name / acronym (sigla), when present. |
camaraComercio | string | Chamber of commerce the matrícula belongs to, e.g. 'ABURRA SUR'. |
codigoCamara | string | Chamber code, e.g. '55'. |
matricula | string | Mercantile registry number (matrícula mercantil) at its chamber. |
claseIdentificacion | string | Identification class: NIT, CEDULA DE CIUDADANIA, SIN IDENTIFICACION... |
estadoMatricula | string | Registry state: ACTIVA, CANCELADA, MATRÍCULA CANCELADA POR ... etc. |
categoriaMatricula | string | Matrícula category, e.g. 'SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL'. |
tipoSociedad | string | Society type, e.g. 'SOCIEDAD COMERCIAL'. |
organizacionJuridica | string | Legal organization, e.g. 'SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS', 'SOCIEDAD ANONIMA'. |
actividadEconomica | string | Primary economic activity, CIIU code (e.g. '4711' retail). |
ciiu3 | string | Secondary CIIU activity code (slot 3). |
ciiu4 | string | Secondary CIIU activity code (slot 4). |
fechaMatricula | string | Matrícula registration date, ISO YYYY-MM-DD. |
fechaRenovacion | string | Last renewal date, ISO YYYY-MM-DD. |
fechaCancelacion | string | Cancellation date, ISO YYYY-MM-DD (null while active). |
fechaVigencia | string | Validity end date, ISO YYYY-MM-DD ('99991231' = indefinite; zero sentinel nulled). |
ultimoAnoRenovado | string | Last renewed year, e.g. '2026'. |
representanteLegal | string | Legal representative's name. |
representanteLegalDocumento | string | Legal representative's document number. |
matchType | string | How the record was found: 'nit' (number lookup) or 'name' (razón-social prefix search). |
sourceQuery | string | The NIT or name prefix this run searched. |
source | string | Source API hostname (datos.gov.co). |
scrapedAt | string | UTC ISO-8601 collection timestamp. |
procurementProfile | object | — |
procurementStatus | string | — |
note | string | — |
error | string | — |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/co/nit -m POST -b '{"nit": "890900608"}'
The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
Colombia company search by name
POST /v1/co/companies/search
Up to 30 Colombian companies whose razón social starts with the given prefix, active matrículas first, with NIT, estado, cámara and activities. Source: national RUES registry.
Use the NIT endpoint for procurement enrichment.
Input
Send a JSON body to POST https://api.ssh.autos/v1/co/companies/search.
| Field | Type | Required | Notes |
|---|---|---|---|
companyName | string | required | Razón social prefix, e.g. 'GRUPO NUTRESA'; active matrículas first. 3–120 characters |
maxResults | integer | optional | 1–30; default 10 |
Returned fields
The answer is JSON: records, a list of up to 30, and summary, the run status and counts. Each record has these 32 fields; a field the source does not publish comes back null.
32 fields per record
| Field | Type | Notes |
|---|---|---|
companyKey | string | Composite unique key: source:matricula:chamber:matricula (e.g. datos.gov.co:matricula:55:3190) — one NIT can carry matrículas in several chambers. |
nit | string | Company NIT without check digit (e.g. '890900608'). Null for legacy rows registered without identification. |
digitoVerificacion | string | Registry check digit (dígito de verificación), e.g. '9'. |
nitCompleto | string | Display form NIT-DV, e.g. '890900608-9'. |
razonSocial | string | Registered company name (razón social). |
sigla | string | Registered short name / acronym (sigla), when present. |
camaraComercio | string | Chamber of commerce the matrícula belongs to, e.g. 'ABURRA SUR'. |
codigoCamara | string | Chamber code, e.g. '55'. |
matricula | string | Mercantile registry number (matrícula mercantil) at its chamber. |
claseIdentificacion | string | Identification class: NIT, CEDULA DE CIUDADANIA, SIN IDENTIFICACION... |
estadoMatricula | string | Registry state: ACTIVA, CANCELADA, MATRÍCULA CANCELADA POR ... etc. |
categoriaMatricula | string | Matrícula category, e.g. 'SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL'. |
tipoSociedad | string | Society type, e.g. 'SOCIEDAD COMERCIAL'. |
organizacionJuridica | string | Legal organization, e.g. 'SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS', 'SOCIEDAD ANONIMA'. |
actividadEconomica | string | Primary economic activity, CIIU code (e.g. '4711' retail). |
ciiu3 | string | Secondary CIIU activity code (slot 3). |
ciiu4 | string | Secondary CIIU activity code (slot 4). |
fechaMatricula | string | Matrícula registration date, ISO YYYY-MM-DD. |
fechaRenovacion | string | Last renewal date, ISO YYYY-MM-DD. |
fechaCancelacion | string | Cancellation date, ISO YYYY-MM-DD (null while active). |
fechaVigencia | string | Validity end date, ISO YYYY-MM-DD ('99991231' = indefinite; zero sentinel nulled). |
ultimoAnoRenovado | string | Last renewed year, e.g. '2026'. |
representanteLegal | string | Legal representative's name. |
representanteLegalDocumento | string | Legal representative's document number. |
matchType | string | How the record was found: 'nit' (number lookup) or 'name' (razón-social prefix search). |
sourceQuery | string | The NIT or name prefix this run searched. |
source | string | Source API hostname (datos.gov.co). |
scrapedAt | string | UTC ISO-8601 collection timestamp. |
procurementProfile | object | — |
procurementStatus | string | — |
note | string | — |
error | string | — |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/co/companies/search -m POST -b '{"companyName": "GRUPO NUTRESA", "maxResults": 3}'
The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Colombia company lookup by NIT: No match returns records: [] (charged).
- Colombia company search by name: No match returns records: [] (charged).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Colombia company lookup by NIT: Invalid NITs and source outages are not charged
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Colombia Company Registry + Public Contract History. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt