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

> Search live contentious-administrative litigation across the Consejo de Estado and every Tribunal and Juzgado Administrativo.

Live contentious-administrative litigation from SAMAI / Consejo de Estado,
spanning the Consejo de Estado and every Tribunal and Juzgado Administrativo.
Search processes by party, radicado, or class, scoped to a corporación (the
deciding despacho).

## Search processes

`POST /co/samai/processes/v1`

| Field         | Type    | Notes                                                                                                      |
| ------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `query`       | string  | **Required.** 2-200 chars. The search term (party, radicado, or class, per `search_type`).                 |
| `search_type` | enum    | `radicado`, `clase`, or `parte`. Default `parte`.                                                          |
| `corporacion` | string  | 5-9 digit corporación code. Required; on a `radicado` search it is derived from the radicado when omitted. |
| `section`     | string  | Section/sala within the corporación.                                                                       |
| `from_date`   | string  | `YYYY-MM-DD`.                                                                                              |
| `to_date`     | string  | `YYYY-MM-DD`.                                                                                              |
| `page`        | integer | 1-1000.                                                                                                    |
| `per_page`    | integer | 1-50. Default `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" }'
```

Returns `total`, `total_pages`, `count`, and the matching rows.

| Field             | Notes                                |
| ----------------- | ------------------------------------ |
| `radicado`        | Process number.                      |
| `corporacion`     | Corporación (despacho) code.         |
| `ponente`         | Reporting magistrate.                |
| `clase`           | Process class.                       |
| `filing_date`     | Filing date.                         |
| `is_current`      | Whether this is the current process. |
| `internal_number` | Internal number.                     |
| `subject`         | Matter.                              |
| `plaintiff`       | Claimant.                            |
| `defendant`       | Respondent.                          |
| `is_private`      | Whether the process is reserved.     |
| `guid`            | Stable identifier for the process.   |
| `official_url`    | Link to the process.                 |

## List corporaciones

`POST /co/samai/corporaciones/v1` takes no fields and returns every corporación
(despacho) with its code and name. Use a code to scope a process search.

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

## List secciones

`POST /co/samai/secciones/v1` returns the sections/salas of a corporación.

| Field         | Type   | Notes                                               |
| ------------- | ------ | --------------------------------------------------- |
| `corporacion` | string | **Required.** Corporación code from the list above. |

```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="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>