> ## 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: traffic fines, sanctions, pending balances and payment agreements in one call.

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.

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

| Field | Type | Notes |
| - | - | - |
| `document_number` | 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 '{ "document_number": "ABC123" }'
```

## Response

| Field | Notes |
| - | - |
| `found` | `true` when an account was returned for the term. |
| `document_number` | The normalized request value (spaces removed, uppercased). |
| `is_plate` | `true` when the value 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, all response fields, and an interactive playground.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.