--- title: "Supersociedades Company File" method: POST path: "/co/supersociedades-baranda/company-file/v1" tags: ["Colombia", "Supersociedades Baranda Virtual"] --- # Supersociedades Company File `POST /co/supersociedades-baranda/company-file/v1` ## Request - Base URL: `https://api.croma.run` - URL: `https://api.croma.run/co/supersociedades-baranda/company-file/v1` - Auth: HTTP bearer A company's or person's file at the Superintendencia de Sociedades, read live from its Baranda Virtual by NIT or cédula: its standing (inspección, vigilancia, control), situation (activa, reorganización, liquidación, ...), stage, cause, activity and domicile; its legal representatives, auditors and accountants; and, ten per page, the decisions (providencias) the Superintendencia issued in its processes and what was filed into them (entradas), newest first, each with the source's viewer link. Asynchronous: the source needs a verification per session. Supports async delivery: set `Prefer: wait=N` for an inline result, pass `callback_url` to receive a POST when ready, or poll `GET /jobs/{id}`. ## Headers - `Idempotency-Key` string - `Prefer` string ## Request body - object - `document_number` string, required: NIT or cédula of the company or person, digits only, no verification digit. 4-15 digits. - `page` integer: 1-based page number for paginated results. - `callback_url` string, uri: POST the job result here when it finishes. ## Response `200` Successful response - SupersociedadesBarandaCompanyFileResponse - `data` SupersociedadesBarandaCompanyFileData, required - `found` boolean, required: False when the source holds no company under the number. - `document_number` string, required: Echoes the request. - `company` object, nullable, required - `document_number` string, required: NIT or cédula, digits only. - `check_digit` string, nullable, required: The NIT's verification digit. - `file_number` string, nullable, required: The company's expediente number at the Superintendencia. - `name` string, nullable, required - `short_name` string, nullable, required: Sigla. - `registration_number` string, nullable, required: Matrícula mercantil. - `registration_date` string, nullable, required: `yyyy-mm-dd`. - `incorporation_date` string, nullable, required: `yyyy-mm-dd`. - `expiry_date` string, nullable, required: Fecha de vencimiento, `yyyy-mm-dd`, when the company has one. - `company_type` string, nullable, required: Tipo de sociedad as the source prints it, e.g. `S. A. S.`, `ANONIMA`. - `supervision_status` string, nullable, required: The company's standing before the Superintendencia: `INSPECCION`, `VIGILANCIA`, `CONTROL`, ... - `supervision_status_date` string, nullable, required - `situation` string, nullable, required: Situación as the source prints it, e.g. `ACTIVA`, `LIQUIDACIÓN VOLUNTARIA`, `REORGANIZACIÓN`. - `situation_date` string, nullable, required - `stage` string, nullable, required: Etapa as the source prints it. - `stage_date` string, nullable, required - `cause` string, nullable, required: The legal cause of the supervision, as the source prints it. - `ciiu_code` string, nullable, required - `activity` string, nullable, required - `purpose` string, nullable, required: Objeto social as the source prints it. - `address` string, nullable, required - `department` string, nullable, required - `city` string, nullable, required - `officers` object[], required: Legal representatives, auditors and accountants the source lists. - `role` string, required: Role as the source prints it, e.g. `REPRESENTANTE LEGAL`, `REVISOR FISCAL`, `CONTADOR`. - `name` string, required - `decisions` object, required: Providencias: the decisions the Superintendencia issued in the company's processes, newest first. - `total` integer, required: Rows the source holds for the company. - `page` integer, required - `per_page` integer, required: Always 10, the source's page. - `results` object[], required - `filing_id` string, required: Número de radicado, `yyyy-01-nnnnnn`. - `file_number` string, nullable, required: Expediente (the process file) the row belongs to, when the source links one. - `previous_filing_id` string, nullable, required: The radicado this one answers or continues, when any. - `filed_date` string, nullable, required: Date of the radicado, `yyyy-mm-dd`. - `filed_at` string, nullable, required: Date and time of the radicado in Bogotá time, when the source stamps one. - `term_days` integer, nullable, required: Término in days, as the source prints it. - `pages` integer, nullable, required: Folios. - `procedure` string, nullable, required: Trámite as the source names it. - `procedure_code` integer, nullable, required: The trámite's numeric code at the source. - `process` string, nullable, required: Proceso as the source names it, e.g. `APOYO JUDICIAL`, `NOTIFICACIÓN`, `REORGANIZACIÓN EMPRESARIAL Y CONCORDATOS`. - `sequence` string, nullable, required: Consecutivo of an estado or traslado, e.g. `415-000374`. - `status` string, nullable, required: Estado of the radicado as the source prints it. - `subject` string, nullable, required: Asunto. - `description` string, nullable, required: Document type as the source prints it. - `company_name` string, nullable, required: Razón social of the company or person the row is about, as the source prints it; the Superintendencia itself on its own estados and traslados. - `company_document_number` string, nullable, required: NIT or cédula of that company or person, digits only. - `city` string, nullable, required - `department` string, nullable, required - `country` string, nullable, required - `source_document_url` string, nullable, required: The source's own viewer link for the radicado's files. - `filings` object, required: Entradas: what was filed into the company's processes, newest first. - `total` integer, required: Rows the source holds for the company. - `page` integer, required - `per_page` integer, required: Always 10, the source's page. - `results` object[], required - `filing_id` string, required: Número de radicado, `yyyy-01-nnnnnn`. - `file_number` string, nullable, required: Expediente (the process file) the row belongs to, when the source links one. - `previous_filing_id` string, nullable, required: The radicado this one answers or continues, when any. - `filed_date` string, nullable, required: Date of the radicado, `yyyy-mm-dd`. - `filed_at` string, nullable, required: Date and time of the radicado in Bogotá time, when the source stamps one. - `term_days` integer, nullable, required: Término in days, as the source prints it. - `pages` integer, nullable, required: Folios. - `procedure` string, nullable, required: Trámite as the source names it. - `procedure_code` integer, nullable, required: The trámite's numeric code at the source. - `process` string, nullable, required: Proceso as the source names it, e.g. `APOYO JUDICIAL`, `NOTIFICACIÓN`, `REORGANIZACIÓN EMPRESARIAL Y CONCORDATOS`. - `sequence` string, nullable, required: Consecutivo of an estado or traslado, e.g. `415-000374`. - `status` string, nullable, required: Estado of the radicado as the source prints it. - `subject` string, nullable, required: Asunto. - `description` string, nullable, required: Document type as the source prints it. - `company_name` string, nullable, required: Razón social of the company or person the row is about, as the source prints it; the Superintendencia itself on its own estados and traslados. - `company_document_number` string, nullable, required: NIT or cédula of that company or person, digits only. - `city` string, nullable, required - `department` string, nullable, required - `country` string, nullable, required - `source_document_url` string, nullable, required: The source's own viewer link for the radicado's files. - `checked_at` string, required: When the source was read, ISO 8601. ## Other responses - `202`: Accepted — the result is being computed asynchronously. Poll `job.status_url` (GET /jobs/{id}) or supply `callback_url` to have the result POSTed to you. Returned when `Prefer: wait` elapses before completion, or immediately when `callback_url` is set. - `400`: Invalid request body - `401`: Missing or invalid API key - `429`: Rate limit exceeded - `500`: Internal error - `502`: Upstream source returned an 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)