> For the complete documentation index, see [llms.txt](https://placapi.gitbook.io/placapi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://placapi.gitbook.io/placapi-docs/empresas-y-estado/procesos-judiciales.md).

# Procesos judiciales

`POST https://placapi.com/api/rama-judicial`

Procesos judiciales de la Consulta de Procesos Nacional Unificada de la Rama Judicial. Se busca por `radicado` (23 dígitos) o por `nombre` de una de las partes, indicando si es persona natural o jurídica. Devuelve despacho, departamento, fechas y las **partes procesales ya separadas por rol** (la fuente las entrega en un solo texto plano). Consultando por radicado agrega además el **detalle** (ponente, tipo y clase de proceso, ubicación del expediente) y las **últimas actuaciones con su anotación**, que es lo que responde "en qué va el proceso" y no solo "existe". `status` es siempre `info` cuando hay procesos, nunca `danger`: la lista incluye tutelas, casos cerrados y procesos donde la persona es la DEMANDANTE. Cuesta 1 crédito. Por nombre, cero procesos es un resultado válido y cobra; un radicado que no existe responde 404 y **no cobra**. Costo: 1 crédito por consulta con datos.

## Parámetros

| Campo         | Tipo    | Obligatorio | Detalle                                                                                                                                                                                                                                        |
| ------------- | ------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `radicado`    | string  | No          | Número de radicado, exactamente 23 dígitos (CCCJJJSSAAAA00000000D: ciudad, juzgado, especialidad, año, consecutivo y dígito de verificación). Los guiones y espacios se ignoran. Se requiere `radicado` o `nombre`. Alias aceptado: `numero`.  |
| `nombre`      | string  | No          | Nombre o razón social de una de las partes. Mínimo 3 caracteres. Si la búsqueda arroja más de mil procesos la fuente la rechaza con 400 `consulta_invalida`: hay que acotarla. Alias aceptado: `razonSocial`.                                  |
| `tipoPersona` | string  | No          | Solo aplica con `nombre`: `nat` (natural) o `jur` (jurídica). Por defecto `nat`. La fuente NO busca en las dos a la vez — pedir una empresa como `nat` devuelve vacío en silencio, que se lee como "no tiene procesos". Valores: `nat`, `jur`. |
| `soloActivos` | boolean | No          | `true` deja solo los procesos activos. Por defecto vienen todos, incluidos los terminados: un proceso cerrado hace dos años sigue siendo información para quien verifica.                                                                      |
| `pagina`      | number  | No          | Página de resultados, empezando en 1. La fuente devuelve 20 procesos por página; `paginacion.cantidadPaginas` dice cuántas hay.                                                                                                                |
| `refresh`     | boolean | No          | Ignora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).                                                                                                             |

## Ejemplo

```bash
curl -X POST 'https://placapi.com/api/rama-judicial' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa": "ABC123"}'
```

El esquema completo de la respuesta está en el [OpenAPI 3.1](https://placapi.com/openapi.json) y en la [referencia interactiva](https://placapi.github.io/reference.html).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://placapi.gitbook.io/placapi-docs/empresas-y-estado/procesos-judiciales.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.