---
title: "Supersociedades Opinion Files Search"
method: POST
path: "/co/supersociedades-relatoria/opinion-files-search/v1"
tags: ["Colombia", "Supersociedades Relatoría"]
---

# Supersociedades Opinion Files Search

`POST /co/supersociedades-relatoria/opinion-files-search/v1`

## Request

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

The conceptos of the Superintendencia de Sociedades as its portal publishes them, one PDF each: about 13,000 conceptos jurídicos of its legal office and about 900 conceptos contables since 2013, searchable by words over the title and epígrafe, by collection, consecutivo, year, whether the Superintendencia marks them as vigente, and date, each with our copy of the file. The consecutivo joins a concepto jurídico to its full text in `documents-search`. 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' | 'legal' | 'accounting': Optional collection: `legal` (conceptos jurídicos), `accounting` (conceptos contables), or `any`.
  - `consecutive` string: Optional consecutivo of the concepto or sentencia, `nnn-nnnnnn`, e.g. `220-001087`.
  - `year` integer: Optional year (1990 or later). 0 searches every year.
  - `in_force` 'any' | 'yes' | 'no': Optional: `yes` for conceptos the Superintendencia marks as vigente, `no` for the ones it marks as no longer in force, 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

- SupersociedadesRelatoriaOpinionFilesSearchResponse
  - `data` SupersociedadesRelatoriaOpinionFilesSearchData, 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` 'legal' | 'accounting', required: `legal` (conceptos jurídicos, the Oficina Asesora Jurídica's oficios 220 and 195) or `accounting` (conceptos contables, the oficios 115).
      - `title` string, required: The file's title at the Superintendencia, e.g. `OFICIO 220-001087 DE 3 DE ENERO DE 2024`.
      - `consecutive` string, nullable, required: The oficio's consecutivo, `nnn-nnnnnn`, e.g. `220-001087`. The same consecutivo names the concepto in the relatoría's `documents`.
      - `subject` string, nullable, required: The epígrafe: what the concepto is about, as the Superintendencia prints it.
      - `issued_date` string, nullable, required: Date of the oficio, `yyyy-mm-dd`.
      - `published_date` string, nullable, required: When the Superintendencia published it, `yyyy-mm-dd`.
      - `year` integer, nullable, required
      - `filing_id` string, nullable, required: Número de radicado the concepto answers, when the Superintendencia notes it.
      - `dependency` string, nullable, required: The office that issued it, as the Superintendencia prints it.
      - `procedure` string, nullable, required: Trámite, as the Superintendencia prints it.
      - `in_force` boolean, nullable, required: Whether the Superintendencia marks the concepto as vigente; null when it does not say.
      - `created_at` string, nullable, required: When the file was uploaded to the Superintendencia.
      - `modified_at` string, nullable, required
      - `bytes` integer, nullable, required
      - `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/df016cdb29d7?raw)