> ## 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 by party, radicado or class 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 |
| - | - | - |
| `search_type` | enum | `radicado`, `clase`, or `parte`. Default `parte`. |
| `query` | string | **Required.** 2-200 chars. The search term (party, radicado, or class, per `search_type`). |
| `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. Default `1`. |
| `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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.