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

> Look up a SIMIT account status by vehicle plate or identification number.

Looks up a SIMIT (Sistema Integrado de Información sobre Multas y Sanciones por
Infracciones de Tránsito) account status. Given a single search term, either a
vehicle plate or a person's identification number, it returns the outstanding
comparendos and multas, the account totals, any payment agreements, and driving
courses.

The same term covers both cases: pass a plate to see a vehicle's fines, or an
identification number to see a person's. The response reports which one matched.

## Request

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

| Field    | Type   | Notes                                                                                                    |
| -------- | ------ | -------------------------------------------------------------------------------------------------------- |
| `filtro` | string | **Required.** A vehicle plate (e.g. `ABC123`) or an identification number. 4-20 alphanumeric characters. |

```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" }'
```

## Response

| Field                | Notes                                                                             |
| -------------------- | --------------------------------------------------------------------------------- |
| `found`              | `true` when an account was returned for the term.                                 |
| `query`              | The normalized search term (spaces removed, uppercased).                          |
| `is_plate_query`     | `true` when the term matched a vehicle plate, `false` when it matched a document. |
| `clear`              | `true` when there is nothing outstanding (paz y salvo).                           |
| `summary`            | Account totals (see below).                                                       |
| `fines`              | The outstanding comparendos and multas (see below).                               |
| `payment_agreements` | Payment agreements (acuerdos de pago).                                            |
| `driving_courses`    | Driving courses (cursos viales).                                                  |

### `summary`

`total` (total owed), `total_fines`, `total_agreements`, `payable_total`, and
`payable_fines_count`. Amounts are numbers in Colombian pesos; missing values are
`null`.

### `fines[]`

| Field                      | Notes                                                                              |
| -------------------------- | ---------------------------------------------------------------------------------- |
| `ticket_number`            | The comparendo number.                                                             |
| `status`                   | Fine status, e.g. `Pendiente`.                                                     |
| `is_comparendo`            | `true` for a comparendo.                                                           |
| `plate`                    | The vehicle plate.                                                                 |
| `traffic_authority`        | The issuing traffic authority (organismo de tránsito).                             |
| `department`               | The department.                                                                    |
| `amount`, `amount_payable` | Original amount and amount currently payable.                                      |
| `infraction_date`          | Infraction date as `yyyy-mm-dd`, or `null`.                                        |
| `offender`                 | The party tied to the fine: `document_type`, `document_number`, `name`.            |
| `infractions[]`            | Each infraction's `code` (e.g. `C40`), `description`, and `amount`.                |
| `payment_projections[]`    | Discount/payment options: `description`, `amount`, `date`, `days`, `instructions`. |

Amounts are numbers, dates are `yyyy-mm-dd`, and missing values are `null`.

<Note>
  This lookup can take longer than a typical request. It's an
  [async job](/async-jobs). By default the request waits inline and returns
  `{ data }`, or you can set `Prefer: wait=N`, poll `GET /jobs/{id}`, or supply a
  `callback_url`.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, response fields, and an interactive playground.
</Card>