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

> Busca litigios contencioso-administrativos en vivo en el Consejo de Estado y en cada Tribunal y Juzgado Administrativo.

Litigios contencioso-administrativos en vivo desde SAMAI / Consejo de Estado,
que abarcan el Consejo de Estado y cada Tribunal y Juzgado Administrativo. Busca
procesos por parte, radicado o clase, acotados a una corporación (el despacho que
decide).

## Buscar procesos

`POST /co/samai/processes/v1`

| Campo         | Tipo    | Notas                                                                                                                 |
| ------------- | ------- | --------------------------------------------------------------------------------------------------------------------- |
| `query`       | string  | **Obligatorio.** 2-200 caracteres. El término de búsqueda (parte, radicado o clase, según `search_type`).             |
| `search_type` | enum    | `radicado`, `clase` o `parte`. Por defecto `parte`.                                                                   |
| `corporacion` | string  | Código de corporación de 5-9 dígitos. Obligatorio; en una búsqueda por `radicado` se deriva del radicado si se omite. |
| `section`     | string  | Sección/sala dentro de la corporación.                                                                                |
| `from_date`   | string  | `YYYY-MM-DD`.                                                                                                         |
| `to_date`     | string  | `YYYY-MM-DD`.                                                                                                         |
| `page`        | integer | 1-1000.                                                                                                               |
| `per_page`    | integer | 1-50. Por defecto `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" }'
```

Devuelve `total`, `total_pages`, `count` y las filas coincidentes.

| Campo             | Notas                                |
| ----------------- | ------------------------------------ |
| `radicado`        | Número de proceso.                   |
| `corporacion`     | Código de la corporación (despacho). |
| `ponente`         | Magistrado ponente.                  |
| `clase`           | Clase del proceso.                   |
| `filing_date`     | Fecha de radicación.                 |
| `is_current`      | Si es el proceso actual.             |
| `internal_number` | Número interno.                      |
| `subject`         | Asunto.                              |
| `plaintiff`       | Demandante.                          |
| `defendant`       | Demandado.                           |
| `is_private`      | Si el proceso es reservado.          |
| `guid`            | Identificador estable del proceso.   |
| `official_url`    | Enlace al proceso.                   |

## Listar corporaciones

`POST /co/samai/corporaciones/v1` no recibe campos y devuelve cada corporación
(despacho) con su código y nombre. Usa un código para acotar una búsqueda de
procesos.

```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` devuelve las secciones/salas de una corporación.

| Campo         | Tipo   | Notas                                                         |
| ------------- | ------ | ------------------------------------------------------------- |
| `corporacion` | string | **Obligatorio.** Código de corporación de la lista de arriba. |

```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="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>