---
title: "Supersociedades Historical Rulings Search"
method: POST
path: "/co/supersociedades-relatoria/historical-rulings-search/v1"
tags: ["Colombia", "Supersociedades Relatoría"]
---

# Supersociedades Historical Rulings Search

`POST /co/supersociedades-relatoria/historical-rulings-search/v1`

## Request

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

The ruling files the Superintendencia de Sociedades keeps on its portal, one PDF each: about 18,000 autos and sentencias of the insolvency delegatura (2012-2021) and about 330 of the mercantile delegatura (2012-2019), searchable by words over the title, description, case and subject, by collection, category, year and date, each with the Superintendencia's metadata and our copy of the file. 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.
  - `collection` 'any' | 'insolvency' | 'mercantile': Optional collection: `insolvency` (rulings of the insolvency delegatura), `mercantile` (rulings of the mercantile delegatura), or `any`.
  - `category` string: Optional category as the Superintendencia names it, e.g. `Liquidaciones`, `Reorganización`, `Régimen de Administradores`.
  - `year` integer: Optional year (1990 or later). 0 searches every year.
  - `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

- SupersociedadesRelatoriaHistoricalRulingsSearchResponse
  - `data` SupersociedadesRelatoriaHistoricalRulingsSearchData, 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: `<collection>:<file id at the Superintendencia>`.
      - `collection` 'insolvency' | 'mercantile', required: `insolvency` (autos and sentencias of the insolvency delegatura, 2012-2021) or `mercantile` (sentencias and autos of the mercantile delegatura, 2012-2019).
      - `title` string, required: The file's title at the Superintendencia: the radicado for insolvency, the sentencia's number and date for mercantile.
      - `description` string, nullable, required: What the Superintendencia says about the file: the parties, or the topics.
      - `category` string, nullable, required: The Superintendencia's category: `Liquidaciones`, `Reorganización`, `Acuerdos Insolv Ejecución`, `Otros`, or a mercantile topic such as `Régimen de Administradores`.
      - `dependency` string, nullable, required: Dependencia de origen, as the Superintendencia prints it.
      - `procedure` string, nullable, required: Trámite, as the Superintendencia prints it.
      - `subject` string, nullable, required: Asunto.
      - `case_name` string, nullable, required: The case as the Superintendencia names it, e.g. `A contra B`.
      - `topic` string, nullable, required: Tema, as the Superintendencia numbers it.
      - `year` integer, nullable, required
      - `issued_date` string, nullable, required: Date of the ruling, `yyyy-mm-dd`.
      - `published_date` string, nullable, required: When the Superintendencia published it, `yyyy-mm-dd`.
      - `created_at` string, nullable, required: When the file was uploaded to the Superintendencia.
      - `modified_at` string, nullable, required
      - `bytes` integer, nullable, required: Size of the file.
      - `document_url` string, nullable, required: Our copy of the PDF.
      - `source_document_url` string, required: The Superintendencia's own link to the PDF.

## 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/74c745980c60?raw)