---
title: "Supersociedades Baranda Publications Search"
method: POST
path: "/co/supersociedades-baranda/publications-search/v1"
tags: ["Colombia", "Supersociedades Baranda Virtual"]
---

# Supersociedades Baranda Publications Search

`POST /co/supersociedades-baranda/publications-search/v1`

## Request

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

Everything the Superintendencia de Sociedades has published on its Baranda Virtual since 2024 (estados, traslados, avisos, sentencias, autos, edictos and publicidad of every delegatura and intendencia regional), searchable by the NIT or cédula of the company or person it is about, by words of its name, subject or trámite, by list, dependencia, radicado, expediente and date. Each result carries the trámite, the dates, the company, the source's viewer link and our copy of the radicado's files. An estado row is the list itself; to search what the notified autos say, use `supersociedades_baranda_decisions_search`. Served by Croma from its copy (`as_of` says how current it is).

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

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `document_number` string: Optional NIT or cédula of the company or person the publication is about, digits only.
  - `query` string: Optional words matched against the company or person name, the subject and the trámite of the publication.
  - `kind` 'any' | 'estado' | 'traslado' | 'aviso' | 'sentencia' | 'auto' | 'edicto' | 'publicidad': Optional list to search: `estado`, `traslado`, `aviso`, `sentencia`, `auto`, `edicto`, `publicidad`, or `any`.
  - `dependency` string: Optional dependencia code as the source keys its lists, e.g. `apoyoJudicialR` (reorganización y concordato), `apoyoJudicialL` (liquidaciones), `apoyoJudicialPM` (procedimientos mercantiles), `notificaciones`, `medellinNew`. Every publication carries its `dependency`.
  - `filing_id` string: Optional número de radicado, `yyyy-01-nnnnnn`.
  - `file_number` string: Optional expediente (process file) number as the source prints it.
  - `from_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `to_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Rows per page, 1-100.

## Response `200`

Successful response

- SupersociedadesBarandaPublicationsSearchResponse
  - `data` SupersociedadesBarandaPublicationsSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `total` integer, required: Matching rows, or the count cap when `total_is_exact` is false.
    - `total_is_exact` boolean, required: False when `total` is the count cap rather than the exact number of matches.
    - `page` integer, required
    - `per_page` integer, required
    - `total_pages` integer, required: A floor when `total_is_exact` is false.
    - `count` integer, required: Rows in this page.
    - `results` object[], required
      - `id` string, required: `<kind>:<dependency>:<radicado>`. A radicado published under two lists is two rows.
      - `kind` 'estado' | 'traslado' | 'aviso' | 'sentencia' | 'auto' | 'edicto' | 'publicidad', required: Which list published it: `estado`, `traslado`, `aviso`, `sentencia`, `auto`, `edicto` or `publicidad`.
      - `dependency` string, required: The dependencia code as the source keys its lists, e.g. `apoyoJudicialR`.
      - `dependency_name` string, nullable, required: The dependencia's label, e.g. `APOYO JUDICIAL - REORGANIZACIÓN Y CONCORDATO`.
      - `filing_id` string, required: Número de radicado of the publication, `yyyy-01-nnnnnn`.
      - `file_number` string, nullable, required: Expediente (the process file) the publication 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, required: Date of the publication, `yyyy-mm-dd`.
      - `filed_at` string, nullable, required: Date and time of the publication 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 the company or person the publication is about, 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.
      - `digitized` string, nullable, required: Whether the source has the radicado's files digitized, as it prints it.
      - `document_url` string, nullable, required: Our copy of the radicado's main file; null when the source serves none.
      - `documents` object[], required: Every file the source lists for the radicado, with our copy of each.
        - `name` string, required: The file name as the source lists it, e.g. `2026-01-706561.PDF`.
        - `document_url` string, nullable, required: Our copy of the file; null when the source lists the file but does not serve it.
        - `source_document_url` string, nullable, required: The source's own viewer link for the radicado.
        - `bytes` integer, nullable, required: Size of our copy in bytes.

## Other responses

- `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)