---
title: "Superfinanciera Regulation"
method: POST
path: "/co/superfinanciera/regulation/v1"
tags: ["Colombia", "Superfinanciera"]
---

# Superfinanciera Regulation

`POST /co/superfinanciera/regulation/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/superfinanciera/regulation/v1`
- Auth: HTTP bearer

Retrieve one act of the Superintendencia Financiera de Colombia by its `regulation_id` from the search results (e.g. `ce:2026:7` for Circular Externa 007 de 2026, `cc:2026:56`, `res:2026:1195`), with its official description, the date it was issued, the bulletin it was published in and a link to the act.

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

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `regulation_id` string, required: Act identifier from the search results (`id`), e.g. `ce:2026:7`, `cc:2026:56`, `res:2026:1195`.

## Response `200`

Successful response

- SuperfinancieraRegulationResponse
  - `data` SuperfinancieraRegulationData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `found` boolean, required
    - `regulation_id` string, required
    - `regulation` object, nullable, required
      - `id` string, required: Stable identifier: kind, year and number, e.g. `ce:2026:7` (Circular Externa 007 de 2026), `cc:2026:56`, `res:2026:1195`. On the two occasions in twenty years where the register printed the same number twice in one year, the bulletin is appended to both (`res:2010:2484:b192`).
      - `kind` 'circular_externa' | 'carta_circular' | 'resolucion', required: `circular_externa` (general instructions binding on supervised entities), `carta_circular` (informative, creates no obligation) or `resolucion` (an administrative act).
      - `number` string, required: The number as the register prints it, leading zeros included: "007", "56", "1195". A handful are written out, e.g. "Conjunta 002" for a circular issued jointly with another superintendencia.
      - `number_key` string, required: The number in the canonical form the `id` uses: lowercased, leading zeros dropped, anything but letters and digits collapsed to a hyphen ("007" becomes "7", "Conjunta 002" becomes "conjunta-002"). Filter on this to match an act whether the caller writes the zeros or not.
      - `year` number, required: Year the act was issued, 2005 or later.
      - `issued_at` string, nullable, required: `yyyy-mm-dd` the act is dated. Null on the few rows where the register prints a date this connector will not guess at rather than inventing one.
      - `title` string, required: The act as it is cited, e.g. "Circular Externa 007 de 2026".
      - `description` string, required: What the act does, in the Superintendencia's own words. This is the official one-line summary the register publishes, not a generated one.
      - `bulletin` string, nullable, required: Issue number of the Boletín del Ministerio de Hacienda y Crédito Público, Capítulo Superintendencia Financiera, where the act was published. Null when the register lists none.
      - `document_url` string, nullable, required: Address of the act itself. Null on the few entries the register lists without a file. The format follows the era: PDF for recent acts, Word for the oldest ones.
      - `attachments` object[], required: Anexos and other files the register links from the description. Empty when there are none.
        - `label` string, required: How the register names the file, e.g. "Anexo".
        - `url` string, required: Address the register links it at.
      - `official_url` string, required: The register page the act is listed on.

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