> ## 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.
# Fiscalía (SPOA)
> Un caso penal colombiano por su número de noticia criminal de 21 dígitos, desde la Fiscalía General de la Nación: estado, etapa, el despacho fiscal asignado, los delitos y las actuaciones no reservadas.
La Fiscalía General de la Nación investiga y acusa los delitos en Colombia.
Toda denuncia o querella que recibe se convierte en una noticia criminal en el
SPOA (Sistema Penal Oral Acusatorio) con un número de 21 dígitos con el que las
partes siguen el caso: el municipio (5 dígitos, DANE), la entidad receptora
(2), la unidad receptora (5), el año (4) y un consecutivo (5).
Envía ese número y obtén el caso tal como lo publica la Fiscalía: en qué
estado está, qué despacho lo tiene, los delitos que se investigan y sus
actuaciones no reservadas.
`POST /co/fiscalia/case/v1` Devuelve un caso penal por su número de noticia criminal.
| Campo | Tipo | Notas |
| --------------------- | ------ | ------------------------------------------------------------------------------------------------- |
| `registration_number` | string | **Obligatorio.** El número de la noticia criminal, de 21 dígitos, p. ej. `110016000050202154481`. |
```bash theme={"dark"}
curl https://api.croma.run/co/fiscalia/case/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "registration_number": "110016000050202154481" }'
```
| Campo | Notas |
| ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `found` | `true` cuando la Fiscalía tiene un caso con este número. `false` es un `200` normal, no un `404`; en ese caso los demás campos son `null` o vacíos. |
| `case_id` | El id interno de la Fiscalía para el caso. |
| `restricted` | `true` para un caso bajo la Ley 1098 de 2006 (infancia y adolescencia). La Fiscalía no los publica, así que solo vienen `law` y `law_code`. |
| `status`, `status_code`, `status_reason` | `ACTIVO` o `INACTIVO`, su código numérico (`1`, `4`), y el motivo por el que se cerró un caso inactivo, p. ej. `Archivo por conducta atipica art.79 c.p.p`. |
| `stage`, `stage_code` | La etapa procesal, p. ej. `INDAGACIÓN` o `INVESTIGACIÓN`, y su código numérico. |
| `law`, `law_code` | La ley procesal aplicable, p. ej. `Ley 906`, y su código numérico. |
| `reserved` | La marca de reserva que la propia Fiscalía pone al caso. |
| `incident_at`, `incident_department`, `incident_municipality` | Cuándo y dónde ocurrieron los hechos. `incident_at` va en ISO 8601, hora de Colombia. |
| `assigned_office` | `{ name, unit, directorate, assigned_date, department, municipality, address, phone, email }`: el despacho fiscal que tiene el caso, su unidad y su dirección seccional, y cómo contactarlo. |
| `crimes` | `{ name, article, grade, status, flag }[]`. `name` tal como se registra, p. ej. `FALSEDAD EN DOCUMENTO PRIVADO. ART. 289 C.P.`; `article` es su artículo del Código Penal (`289`); `grade` es p. ej. `AGRAVADO`, o `null` cuando no se registra ninguno; `status` es el estado del delito en el caso, p. ej. `ACTIVO`; `flag` es una marca `SI` / `NO` que la Fiscalía registra en cada delito, tal cual. |
| `actions` | `{ action_date, action_type }[]`: las actuaciones no reservadas del caso, de la más reciente a la más antigua. |
| `actions_truncated` | `true` cuando la Fiscalía publica solo parte de un historial largo; en ese caso faltan las actuaciones más antiguas. |
| `last_action` | `{ action_type, action_code, occurred_at, recorded_at }` de la última actuación, con su hora, o `null`. |
| `joined`, `joined_to`, `joined_to_case_id` | Si el caso se acumuló a otro por conexidad, y el número y el id interno de ese caso. |
La Fiscalía no publica los casos bajo la Ley 1098 de 2006 (Código de la
Infancia y la Adolescencia). Responden `found: true` y `restricted: true`,
sin más detalles.
Esquemas, todos los campos de respuesta y un playground interactivo.