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

# Supersociedades Bulletins Search

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

## Request

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

The bulletins of the Superintendencia de Sociedades: the monthly Boletín de Conceptos Jurídicos since 2010 and the Boletín de Conceptos Contables by semester of its legal office, plus the mercantile delegatura's compilations (the six volumes of its Boletín de Jurisprudencia and the four Libros de Jurisprudencia Societaria), searchable by words over the title and summary, by series and date, each with our copy of the PDF where the Superintendencia hosts it. 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.
  - `series` 'any' | 'legal_opinions' | 'accounting' | 'jurisprudence': Optional series: `legal_opinions` (Boletín de Conceptos Jurídicos), `accounting` (Boletín de Conceptos Contables), `jurisprudence` (Boletín de Jurisprudencia and Libros de Jurisprudencia Societaria of the mercantile delegatura), 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

- SupersociedadesRelatoriaBulletinsSearchResponse
  - `data` SupersociedadesRelatoriaBulletinsSearchData, 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: The bulletin's identifier at the Superintendencia; `jurisprudence:<file>` for the mercantile delegatura's compilations.
      - `series` 'legal_opinions' | 'accounting' | 'jurisprudence', required: `legal_opinions` (Boletín de Conceptos Jurídicos, monthly), `accounting` (Boletín de Conceptos Contables, by semester) or `jurisprudence` (the mercantile delegatura's Boletín de Jurisprudencia volumes and Libros de Jurisprudencia Societaria).
      - `title` string, required
      - `issue_date` string, nullable, required: The issue's own date, `yyyy-mm-dd`.
      - `published_date` string, nullable, required: When the Superintendencia published it, `yyyy-mm-dd`; null for a compilation the Superintendencia only links elsewhere.
      - `summary` string, nullable, required: What the issue covers, as the Superintendencia summarizes it.
      - `page_url` string, nullable, required: The issue's page at the Superintendencia.
      - `document_url` string, nullable, required: Our copy of the PDF.
      - `source_document_url` string, nullable, required: The Superintendencia's own link to the PDF, or the external viewer it points to for a compilation it does not host.
      - `bytes` integer, nullable, required
      - `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)