> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Corte Constitucional

> Busque em todas as decisões da Corte Constitucional da Colômbia desde 1992, tutelas, constitucionalidade, unificação e autos, e leia o texto completo de qualquer uma.

A Corte Constitucional da Colômbia proferiu cerca de 50.000 decisões desde 1992: sentenças de tutela (T), de constitucionalidade (C), de unificação (SU) e autos (A). Cada uma chega aqui com seu texto completo, o que a Corte decidiu, os direitos em jogo, o magistrado relator, o expediente e um link para a decisão no site da Corte.

Busque em todas de uma vez, por tipo, ano, expediente, relator ou data, ou com texto livre que alcança o corpo de cada decisão.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Buscar decisões

`POST /co/corte-constitucional/rulings-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma única busca sobre o texto completo de todas as decisões desde 1992, filtrada por tipo, ano, expediente, relator ou data.

| Campo                 | Tipo    | Notas                                                                                                                                      |
| --------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `query`               | string  | Palavras opcionais buscadas no número da decisão, no expediente, nos temas, na síntese, no que foi decidido e no texto completo.           |
| `type`                | string  | Tipo de decisão opcional: `T` (tutela), `C` (constitucionalidade), `SU` (unificação) ou `A` (auto). Os nomes em espanhol também funcionam. |
| `year`                | integer | Ano opcional da decisão (o 2025 da T-013/25). 0 busca em todos os anos. Por padrão `0`.                                                    |
| `registration_number` | string  | Expediente opcional, como a Corte o escreve: `T-10417884`, `D-15234`. Maiúsculas e espaços são ignorados.                                  |
| `reporting_judge`     | string  | Magistrado relator opcional, pelo nome completo como aparece em `reporting_judges`. Maiúsculas e acentos são ignorados.                    |
| `from_date`           | string  | Opcional: só decisões proferidas nesta data ou depois, `yyyy-mm-dd`.                                                                       |
| `to_date`             | string  | Opcional: só decisões proferidas nesta data ou antes, `yyyy-mm-dd`.                                                                        |
| `page`                | integer | Número da página, começa em 1. Por padrão `1`.                                                                                             |
| `per_page`            | integer | Resultados por página (1-50). Por padrão `20`.                                                                                             |

```bash theme={"dark"}
curl https://api.croma.run/co/corte-constitucional/rulings-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "mínimo vital", "type": "T" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` (correspondências em todas as páginas), `page`, `per_page`, `total_pages`, `count` e `results[]`, da decisão mais recente à mais antiga. Cada resultado traz `id` (o número da decisão em forma canônica, p. ex. `T-013/25`), `number` (como a Corte o imprime), `relatoria_id`, `type` e `type_code` (`T`, `C`, `SU` ou `A`), `year`, `ruling_date`, `publication_date`, `proceeding_type`, `chamber`, `registration_number` (o expediente), `reporting_judges[]` e `reporting_judge_keys[]`, `subject`, `summary` (a síntese da relatoría), `decision` (o que a Corte decidiu), `rights_invoked[]`, `rights_protected[]`, `lower_instances[]`, `related_relatoria_ids[]`, `updated_at` e `official_url` (a página da decisão no site da Corte).

<Note>
  Os resultados da busca não incluem o texto da decisão: uma única decisão pode ter centenas de milhares de caracteres. `query` busca dentro dele, então uma frase do corpo encontra a decisão; para ler o texto use o endpoint Corte Constitucional Ruling.
</Note>

## Uma decisão, completa

`POST /co/corte-constitucional/ruling/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

| Campo       | Tipo    | Notas                                                                                                                                                                                                                     |
| ----------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ruling_id` | string  | **Obrigatório.** O número da decisão em qualquer das notações da Corte (`T-013/25`, `SU.502/25`, `A. 006/25`, `T-013-25`), ou o `relatoria_id` de um resultado de busca ou do `related_relatoria_ids[]` de outra decisão. |
| `offset`    | integer | Primeiro caractere do texto a retornar. Envie o `next_offset` da resposta anterior para continuar lendo. Por padrão `0`.                                                                                                  |
| `limit`     | integer | Quantos caracteres do texto retornar. A maioria das decisões cabe em uma resposta; as mais longas passam de um milhão de caracteres. Por padrão `200000`.                                                                 |

```bash theme={"dark"}
curl https://api.croma.run/co/corte-constitucional/ruling/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ruling_id": "T-013/25" }'
```

Retorna `as_of`, `found`, `ruling_id` e `ruling`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto completo da decisão, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o número da decisão em forma canônica, p. ex. `T-013/25`), `number` (como a Corte o imprime), `relatoria_id`, `type` e `type_code` (`T`, `C`, `SU` ou `A`), `year`, `ruling_date`, `publication_date`, `proceeding_type`, `chamber`, `registration_number` (o expediente), `reporting_judges[]` e `reporting_judge_keys[]`, `subject`, `summary` (a síntese da relatoría), `decision` (o que a Corte decidiu), `rights_invoked[]`, `rights_protected[]`, `lower_instances[]`, `related_relatoria_ids[]`, `updated_at` e `official_url` (a página da decisão no site da Corte).

<Note>
  As decisões longas passam de um milhão de caracteres, então o texto é lido por intervalos: envie `offset` e `limit`, depois passe o `next_offset` da resposta como `offset` até que `has_more` seja falso.
</Note>

<Note>
  Um número que a Corte ainda não publicou retorna `found: false` com HTTP 200, não um erro. A Corte publica uma decisão até um ano depois de proferi-la, então uma decisão recente pode retornar `found: false` hoje e aparecer no mês seguinte.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>