> ## 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 o estado de conta do SIMIT por placa de veículo ou número de identificação.

Consulta o estado de conta do SIMIT (Sistema Integrado de Información sobre
Multas y Sanciones por Infracciones de Tránsito). Dado um único termo de
busca, uma placa de veículo ou o número de identificação de uma pessoa,
retorna os comparendos e multas pendentes, os totais da conta, os
acordos de pagamento e os cursos de trânsito.

O mesmo termo cobre os dois casos: use uma placa para ver as multas de um
veículo, ou um número de identificação para ver as de uma pessoa. A resposta
indica qual dos dois correspondeu.

## Requisição

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

| Campo             | Tipo   | Notas                                                                                                                         |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| `document_number` | string | **Obrigatório.** Uma placa de veículo (p. ex. `ABC123`) ou um número de identificação. Entre 4 e 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 '{ "document_number": "ABC123" }'
```

## Resposta

| Campo                | Notas                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------- |
| `found`              | `true` quando uma conta foi retornada para o termo.                                         |
| `document_number`    | O valor normalizado da requisição (sem espaços, em maiúsculas).                             |
| `is_plate`           | `true` quando o valor correspondeu a uma placa, `false` quando correspondeu a um documento. |
| `clear`              | `true` quando não há nada pendente (paz y salvo).                                           |
| `summary`            | Totais da conta (ver abaixo).                                                               |
| `fines`              | Os comparendos e multas pendentes (ver abaixo).                                             |
| `payment_agreements` | Acordos de pagamento.                                                                       |
| `driving_courses`    | Cursos de trânsito.                                                                         |

### `summary`

`total` (total devido), `total_fines`, `total_agreements`, `payable_total` e
`payable_fines_count`. Os montantes são números em pesos colombianos; os valores
ausentes são `null`.

### `fines[]`

| Campo                      | Notas                                                                                    |
| -------------------------- | ---------------------------------------------------------------------------------------- |
| `ticket_number`            | O número do comparendo.                                                                  |
| `status`                   | Estado da multa, p. ex. `Pendiente`.                                                     |
| `is_comparendo`            | `true` para um comparendo.                                                               |
| `plate`                    | A placa do veículo.                                                                      |
| `traffic_authority`        | O organismo de trânsito que a impôs.                                                     |
| `department`               | O departamento.                                                                          |
| `amount`, `amount_payable` | Montante original e montante a pagar atualmente.                                         |
| `infraction_date`          | Data da infração como `yyyy-mm-dd`, ou `null`.                                           |
| `offender`                 | A parte associada à multa: `document_type`, `document_number`, `name`.                   |
| `infractions[]`            | De cada infração: `code` (p. ex. `C40`), `description` e `amount`.                       |
| `payment_projections[]`    | Opções de desconto e pagamento: `description`, `amount`, `date`, `days`, `instructions`. |

Os montantes são números, as datas são `yyyy-mm-dd` e os valores ausentes são
`null`.

<Note>
  Esta consulta pode demorar mais do que uma requisição típica. É um
  [trabalho assíncrono](/pt/async-jobs). Por padrão a requisição aguarda de forma síncrona e
  retorna `{ data }`, ou você pode definir `Prefer: wait=N`, consultar
  `GET /jobs/{id}`, ou fornecer uma `callback_url`.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>