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

# SAMAI (Consejo de Estado)

> Busque litígios contencioso-administrativos ao vivo no Consejo de Estado e em cada Tribunal e Juzgado Administrativo.

Litígios contencioso-administrativos ao vivo do SAMAI / Consejo de Estado,
abrangendo o Consejo de Estado e cada Tribunal e Juzgado Administrativo. Busque
processos por parte, radicado ou clase, restritos a uma corporación (o despacho
que decide).

## Buscar processos

`POST /co/samai/processes/v1`

| Campo         | Tipo    | Notas                                                                                                              |
| ------------- | ------- | ------------------------------------------------------------------------------------------------------------------ |
| `query`       | string  | **Obrigatório.** 2-200 caracteres. O termo de busca (parte, radicado ou clase, conforme `search_type`).            |
| `search_type` | enum    | `radicado`, `clase` ou `parte`. Por padrão `parte`.                                                                |
| `corporacion` | string  | Código de corporación de 5-9 dígitos. Obrigatório; em uma busca por `radicado`, é derivado do radicado se omitido. |
| `section`     | string  | Seção/sala dentro da corporación.                                                                                  |
| `from_date`   | string  | `YYYY-MM-DD`.                                                                                                      |
| `to_date`     | string  | `YYYY-MM-DD`.                                                                                                      |
| `page`        | integer | 1-1000.                                                                                                            |
| `per_page`    | integer | 1-50. Por padrão `10`.                                                                                             |

```bash theme={"dark"}
curl https://api.croma.run/co/samai/processes/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "search_type": "parte", "query": "BANCOLOMBIA", "corporacion": "1100103" }'
```

Retorna `total`, `total_pages`, `count` e as linhas correspondentes.

| Campo             | Notas                              |
| ----------------- | ---------------------------------- |
| `radicado`        | Número do processo.                |
| `corporacion`     | Código da corporación (despacho).  |
| `ponente`         | Magistrado ponente.                |
| `clase`           | Classe do processo.                |
| `filing_date`     | Data de radicación.                |
| `is_current`      | Se é o processo atual.             |
| `internal_number` | Número interno.                    |
| `subject`         | Assunto.                           |
| `plaintiff`       | Demandante.                        |
| `defendant`       | Demandado.                         |
| `is_private`      | Se o processo é reservado.         |
| `guid`            | Identificador estável do processo. |
| `official_url`    | Link para o processo.              |

## Listar corporaciones

`POST /co/samai/corporaciones/v1` não recebe campos e retorna cada corporación
(despacho) com seu código e nome. Use um código para restringir uma busca de
processos.

```bash theme={"dark"}
curl https://api.croma.run/co/samai/corporaciones/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Listar secciones

`POST /co/samai/secciones/v1` retorna as seções/salas de uma corporación.

| Campo         | Tipo   | Notas                                                  |
| ------------- | ------ | ------------------------------------------------------ |
| `corporacion` | string | **Obrigatório.** Código de corporación da lista acima. |

```bash theme={"dark"}
curl https://api.croma.run/co/samai/secciones/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "corporacion": "1100103" }'
```

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