---
title: "Supersociedades Relatoría Document"
method: POST
path: "/co/supersociedades-relatoria/document/v1"
tags: ["Colombia", "Supersociedades Relatoría"]
---

# Supersociedades Relatoría Document

`POST /co/supersociedades-relatoria/document/v1`

## Request

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

One concepto jurídico or sentencia of the Superintendencia de Sociedades by its identifier, whole: the full text as the relatoría transcribed it, the legal sources and citations, the parties, the problemas jurídicos with the doctrinal positions on them, and the sentencia split in its parts (facts, claims, considerations, resolution). 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
  - `id` string, required: The document's identifier, as a search result carries it in `id`.

## Response `200`

Successful response

- SupersociedadesRelatoriaDocumentResponse
  - `data` SupersociedadesRelatoriaDocumentData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `found` boolean, required
    - `id` string, required: Echoes the request.
    - `document` object, nullable, required
      - `id` string, required: The document's identifier at the relatoría.
      - `content_type` 'legal_opinion' | 'ruling' | 'oral_ruling' | 'topic', required: `legal_opinion` (concepto jurídico), `ruling` (sentencia escrita), `oral_ruling` (sentencia en audiencia, published as a video) or `topic` (tema y problema).
      - `title` string, nullable, required: The title as the relatoría prints it; a concepto's starts with its consecutivo.
      - `ruling_title` string, nullable, required: The sentencia's own title, when the relatoría gives one apart.
      - `consecutive` string, nullable, required: Consecutivo of the concepto or sentencia, e.g. `220-123456` or `810-000056`.
      - `filing_id` string, nullable, required: Número de radicado, `yyyy-01-nnnnnn`.
      - `case_number` string, nullable, required: Número de proceso of a sentencia, e.g. `2019-800-00212`.
      - `subject` string, nullable, required: Tema as the relatoría names it, e.g. `Responsabilidad de los administradores`.
      - `procedure` string, nullable, required: Trámite of a sentencia, e.g. `Proceso verbal`.
      - `decided_date` string, nullable, required: Date of the sentencia or of the concepto, `yyyy-mm-dd`.
      - `year` integer, nullable, required: Year of the expediente.
      - `legal_basis` string, nullable, required: Normatividad the relatoría names as the basis of the decision.
      - `modified_date` string, nullable, required: When the relatoría last edited the document, `yyyy-mm-dd`; null on documents it never re-edited.
      - `descriptors` string[], required: Main descriptors of the relatoría's thesaurus, e.g. `Administradores`.
      - `secondary_descriptors` string[], required: Secondary descriptors, e.g. `Deberes`.
      - `legal_sources` object[], required: Fuentes jurídicas the document rests on.
        - `type` string, nullable, required: `Legal`, `Jurisprudencial`, `Doctrinal`, as the relatoría classes it.
        - `source` string, required: The norm or precedent as cited, e.g. `Artículo 24 del Código General del Proceso`.
        - `status` string, nullable, required: `Vigente`, `Derogado`, ... when the relatoría notes it.
        - `link` string, nullable, required: A link to the norm, when the relatoría gives one.
      - `citations` object[], required: What the document cites.
        - `type` string, nullable, required: `Legal`, `Jurisprudencial`, `Doctrinal`, as the relatoría classes it.
        - `source` string, required: The norm or precedent as cited, e.g. `Artículo 24 del Código General del Proceso`.
        - `status` string, nullable, required: `Vigente`, `Derogado`, ... when the relatoría notes it.
        - `link` string, nullable, required: A link to the norm, when the relatoría gives one.
      - `parties` object[], required: The parties of a sentencia, as the relatoría lists them; empty on conceptos.
        - `role` string, nullable, required: `DEMANDANTE`, `DEMANDADO`, ... as the relatoría prints it.
        - `document_type` string, nullable, required: `NIT`, `CÉDULA`, ...
        - `document_number` string, nullable, required
        - `name` string, nullable, required
      - `party_document_numbers` string[], required: NITs and cédulas of the parties, digits only.
      - `questions` object[], required: Problemas jurídicos and the doctrinal positions on them.
        - `question` string, required: The problema jurídico as the relatoría phrases it.
        - `current_position` string, nullable, required: The Superintendencia's current doctrinal position.
        - `contrary_position` string, nullable, required: The position it moved away from, when any.
        - `reiteration` string, nullable, required: Whether and where the position was reiterated.
      - `sections` object, nullable, required: The sentencia split in its parts, when the relatoría did so.
        - `background` string, nullable, required: Antecedentes.
        - `facts` string, nullable, required: Hechos.
        - `claims` string, nullable, required: Pretensiones.
        - `considerations` string, nullable, required: Consideraciones.
        - `costs` string, nullable, required: Costas.
        - `resolution` string, nullable, required: Resuelve.
      - `text` string, nullable, required: The full text of the concepto or sentencia, as the relatoría transcribed it.
      - `text_length` integer, required: Characters in `text`.
      - `video_url` string, nullable, required: The recording of an oral ruling, at the source.
      - `source_url` string, required: The document at the relatoría.

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