> ## 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)
> Um caso penal colombiano pelo número de noticia criminal de 21 dígitos, a partir da Fiscalía General de la Nación: situação, etapa, o gabinete do promotor designado, os crimes e os atos não reservados.
A Fiscalía General de la Nación investiga e acusa os crimes na Colômbia.
Toda denúncia ou queixa que recebe se torna uma noticia criminal no SPOA
(Sistema Penal Oral Acusatorio) com um número de 21 dígitos que as partes usam
para acompanhar o caso: o município (5 dígitos, DANE), a entidade receptora
(2), a unidade receptora (5), o ano (4) e um sequencial (5).
Envie esse número e receba o caso como a Fiscalía o publica: em que situação
está, qual gabinete o tem, os crimes investigados e seus atos não reservados.
`POST /co/fiscalia/case/v1` Retorna um caso penal pelo número da noticia criminal.
| Campo | Tipo | Notas |
| --------------------- | ------ | ---------------------------------------------------------------------------------------------- |
| `registration_number` | string | **Obrigatório.** O número da noticia criminal, com 21 dígitos, p. ex. `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` quando a Fiscalía tem um caso com este número. `false` é um `200` normal, não um `404`; nesse caso os demais campos são `null` ou vazios. |
| `case_id` | O id interno da Fiscalía para o caso. |
| `restricted` | `true` para um caso sob a Ley 1098 de 2006 (infância e adolescência). A Fiscalía não os publica, então só vêm `law` e `law_code`. |
| `status`, `status_code`, `status_reason` | `ACTIVO` ou `INACTIVO`, seu código numérico (`1`, `4`), e o motivo pelo qual um caso inativo foi encerrado, p. ex. `Archivo por conducta atipica art.79 c.p.p`. |
| `stage`, `stage_code` | A etapa processual, p. ex. `INDAGACIÓN` ou `INVESTIGACIÓN`, e seu código numérico. |
| `law`, `law_code` | A lei processual aplicável, p. ex. `Ley 906`, e seu código numérico. |
| `reserved` | A marca de reserva que a própria Fiscalía coloca no caso. |
| `incident_at`, `incident_department`, `incident_municipality` | Quando e onde os fatos ocorreram. `incident_at` vem em ISO 8601, horário da Colômbia. |
| `assigned_office` | `{ name, unit, directorate, assigned_date, department, municipality, address, phone, email }`: o gabinete do promotor que cuida do caso, sua unidade e sua direção seccional, e como contatá-lo. |
| `crimes` | `{ name, article, grade, status, flag }[]`. `name` como registrado, p. ex. `FALSEDAD EN DOCUMENTO PRIVADO. ART. 289 C.P.`; `article` é o artigo do Código Penal (`289`); `grade` é p. ex. `AGRAVADO`, ou `null` quando nenhum é registrado; `status` é a situação do crime no caso, p. ex. `ACTIVO`; `flag` é uma marca `SI` / `NO` que a Fiscalía registra em cada crime, publicada como está. |
| `actions` | `{ action_date, action_type }[]`: os atos não reservados do caso, do mais recente ao mais antigo. |
| `actions_truncated` | `true` quando a Fiscalía publica só parte de um histórico longo; nesse caso faltam os atos mais antigos. |
| `last_action` | `{ action_type, action_code, occurred_at, recorded_at }` do último ato, com o horário, ou `null`. |
| `joined`, `joined_to`, `joined_to_case_id` | Se o caso foi reunido a outro por conexão (conexidad), e o número e o id interno desse caso. |
A Fiscalía não publica os casos sob a Ley 1098 de 2006 (Código de la
Infancia y la Adolescencia). Eles respondem `found: true` e
`restricted: true`, sem outros detalhes.
Esquemas, todos os campos de resposta e um playground interativo.