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

# SIMIT

> Consulta el estado de cuenta del SIMIT por placa de vehículo o número de identificación.

Consulta el estado de cuenta del SIMIT (Sistema Integrado de Información sobre
Multas y Sanciones por Infracciones de Tránsito). Dado un único término de
búsqueda, una placa de vehículo o el número de identificación de una persona,
devuelve los comparendos y multas pendientes, los totales de la cuenta, los
acuerdos de pago y los cursos viales.

El mismo término cubre ambos casos: usa una placa para ver las multas de un
vehículo, o un número de identificación para ver las de una persona. La respuesta
indica cuál de los dos correspondió.

## Solicitud

`POST /co/simit/account-status/v1`

| Campo    | Tipo   | Notas                                                                                                                          |
| -------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| `filtro` | string | **Obligatorio.** Una placa de vehículo (p. ej. `ABC123`) o un número de identificación. Entre 4 y 20 caracteres alfanuméricos. |

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

## Respuesta

| Campo                | Notas                                                                                          |
| -------------------- | ---------------------------------------------------------------------------------------------- |
| `found`              | `true` cuando se devolvió una cuenta para el término.                                          |
| `query`              | El término normalizado (sin espacios, en mayúsculas).                                          |
| `is_plate_query`     | `true` cuando el término correspondió a una placa, `false` cuando correspondió a un documento. |
| `clear`              | `true` cuando no hay nada pendiente (paz y salvo).                                             |
| `summary`            | Totales de la cuenta (ver abajo).                                                              |
| `fines`              | Los comparendos y multas pendientes (ver abajo).                                               |
| `payment_agreements` | Acuerdos de pago.                                                                              |
| `driving_courses`    | Cursos viales.                                                                                 |

### `summary`

`total` (total adeudado), `total_fines`, `total_agreements`, `payable_total` y
`payable_fines_count`. Los montos son números en pesos colombianos; los valores
ausentes son `null`.

### `fines[]`

| Campo                      | Notas                                                                                  |
| -------------------------- | -------------------------------------------------------------------------------------- |
| `ticket_number`            | El número del comparendo.                                                              |
| `status`                   | Estado de la multa, p. ej. `Pendiente`.                                                |
| `is_comparendo`            | `true` para un comparendo.                                                             |
| `plate`                    | La placa del vehículo.                                                                 |
| `traffic_authority`        | El organismo de tránsito que la impuso.                                                |
| `department`               | El departamento.                                                                       |
| `amount`, `amount_payable` | Monto original y monto a pagar actualmente.                                            |
| `infraction_date`          | Fecha de la infracción como `yyyy-mm-dd`, o `null`.                                    |
| `offender`                 | La parte asociada a la multa: `document_type`, `document_number`, `name`.              |
| `infractions[]`            | De cada infracción: `code` (p. ej. `C40`), `description` y `amount`.                   |
| `payment_projections[]`    | Opciones de descuento y pago: `description`, `amount`, `date`, `days`, `instructions`. |

Los montos son números, las fechas son `yyyy-mm-dd` y los valores ausentes son
`null`.

<Note>
  Esta consulta puede tardar más que una solicitud típica. Es un
  [trabajo asíncrono](/async-jobs). Por defecto la solicitud espera en línea y
  devuelve `{ data }`, o puedes definir `Prefer: wait=N`, consultar
  `GET /jobs/{id}`, o entregar una `callback_url`.
</Note>

<Card title="Referencia completa" icon="code" href="/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>