---
title: "Supersociedades Notices Search"
method: POST
path: "/co/supersociedades-relatoria/notices-search/v1"
tags: ["Colombia", "Supersociedades Relatoría"]
---

# Supersociedades Notices Search

`POST /co/supersociedades-relatoria/notices-search/v1`

## Request

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

The notices the Superintendencia de Sociedades publishes on its portal since 2006: avisos of agentes interventores, reorganizations, judicial and mandatory liquidations, liquidations by adjudication, special proceedings and general insolvency matters, each with its text and our copy of its files; and the autos of civil courts on insolvency processes, which the Superintendencia lists for about a week and this copy keeps. Searchable by words over the title and text, by kind and date. Served by Croma from its copy.

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

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Optional words matched against the title, the subject and the full text.
  - `kind` 'any' | 'intervention' | 'reorganization' | 'judicial_liquidation' | 'mandatory_liquidation' | 'adjudication' | 'special' | 'general' | 'court_order': Optional kind of notice: `intervention`, `reorganization`, `judicial_liquidation`, `mandatory_liquidation`, `adjudication`, `special`, `general`, `court_order`, or `any`.
  - `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

- SupersociedadesRelatoriaNoticesSearchResponse
  - `data` SupersociedadesRelatoriaNoticesSearchData, 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: `notice:<id>` for an aviso, `order:<file id>` for a court order.
      - `kind` 'intervention' | 'reorganization' | 'judicial_liquidation' | 'mandatory_liquidation' | 'adjudication' | 'special' | 'general' | 'court_order', required: `intervention` (agentes interventores), `reorganization`, `judicial_liquidation`, `mandatory_liquidation`, `adjudication` (liquidación por adjudicación), `special` (procesos especiales), `general` (avisos generales de insolvencia) or `court_order` (autos de juzgados on insolvency processes).
      - `title` string, required
      - `published_date` string, required: When the Superintendencia published it, `yyyy-mm-dd`.
      - `expires_date` string, nullable, required: When the Superintendencia takes it down, `yyyy-mm-dd`, when it says so.
      - `body_text` string, nullable, required: The aviso's text, as published.
      - `description` string, nullable, required: The Superintendencia's description of a court order.
      - `document_url` string, nullable, required: Our copy of the main file.
      - `source_document_url` string, nullable, required: The Superintendencia's own link to the main file.
      - `documents` object[], required: Every file the Superintendencia links from the notice, with our copy of each.
        - `name` string, required: The file name as the source publishes it.
        - `document_url` string, nullable, required: Our copy of the file; null when the source links a file it does not serve.
        - `source_document_url` string, required: The source's own link to the file.
        - `bytes` integer, nullable, required: Size of our copy in bytes.
      - `modified_at` string, nullable, required

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