---
title: "Supersociedades Filing by Radicado"
method: POST
path: "/co/supersociedades-baranda/filing/v1"
tags: ["Colombia", "Supersociedades Baranda Virtual"]
---

# Supersociedades Filing by Radicado

`POST /co/supersociedades-baranda/filing/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/supersociedades-baranda/filing/v1`
- Auth: HTTP bearer

One radicado of the Superintendencia de Sociedades read live from its Baranda Virtual: the trámite, the process, the dates, the company or person it is about, the source's viewer link, and the other radicados of the same expediente. 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
  - `filing_id` string, required: Número de radicado as the Superintendencia prints it, `yyyy-01-nnnnnn`.
  - `callback_url` string, uri: POST the job result here when it finishes.

## Response `200`

Successful response

- SupersociedadesBarandaFilingResponse
  - `data` SupersociedadesBarandaFilingData, required
    - `found` boolean, required
    - `filing_id` string, required: Echoes the request.
    - `filing` object, nullable, 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.
    - `related` object[], required: Radicados the source associates with the same expediente.
      - `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)