---
title: "SIMIT Account Status"
method: POST
path: "/co/simit/account-status/v1"
tags: ["Colombia", "SIMIT"]
---

# SIMIT Account Status

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

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/simit/account-status/v1`
- Auth: HTTP bearer

Look up a SIMIT (Sistema Integrado de Información sobre Multas y Sanciones por Infracciones de Tránsito) account status by vehicle plate or by a person's identification number. Returns outstanding comparendos and multas (each with the offending party, infraction codes and descriptions, traffic authority, department, amounts, and the discount/payment projections), the account totals, any payment agreements (acuerdos de pago), and driving courses (cursos viales). `is_plate` reports whether the value was matched as a plate. `clear: true` means paz y salvo (nothing outstanding).

Supports async delivery: set `Prefer: wait=N` for an inline result, pass `callback_url` to receive a POST when ready, or poll `GET /jobs/{id}`.

## Headers

- `Idempotency-Key` string
- `Prefer` string

## Request body

- object
  - `document_number` string, required: Vehicle plate (e.g. `ABC123`) or identification number to look up.
  - `callback_url` string, uri: POST the job result here when it finishes.

## Response `200`

Successful response

- SimitAccountStatusResponse
  - `data` SimitAccountStatusData, required
    - `found` boolean, required: Whether the lookup returned an account (false only on a genuinely empty result).
    - `document_number` string, required: Echoes the request value (spaces stripped, uppercased).
    - `is_plate` boolean, required: True when the value was matched as a vehicle plate rather than a document.
    - `clear` boolean, required: True when there is nothing outstanding (paz y salvo).
    - `summary` object, required
      - `total` number, nullable, required
      - `total_fines` number, nullable, required
      - `total_agreements` number, nullable, required
      - `payable_total` number, nullable, required
      - `payable_fines_count` number, nullable, required
    - `fines` object[], required
      - `ticket_number` string, nullable, required
      - `status` string, nullable, required
      - `is_comparendo` boolean, nullable, required
      - `plate` string, nullable, required
      - `traffic_authority` string, nullable, required
      - `department` string, nullable, required
      - `amount` number, nullable, required
      - `amount_payable` number, nullable, required
      - `infraction_date` string, nullable, required: Infraction date (yyyy-mm-dd), or null.
      - `offender` object, required
        - `document_type` string, nullable, required
        - `document_number` string, nullable, required
        - `name` string, nullable, required: Offender name. The source masks it before publishing.
      - `infractions` object[], required
        - `code` string, nullable, required
        - `description` string, nullable, required
        - `amount` number, nullable, required
      - `payment_projections` object[], required
        - `description` string, nullable, required
        - `amount` number, nullable, required
        - `date` string, nullable, required: Deadline date (yyyy-mm-dd), or null when not a parseable date.
        - `days` number, nullable, required
        - `instructions` string, nullable, required
    - `payment_agreements` unknown[], required: Payment agreements (acuerdos de pago), passed through from the source.
      - unknown
    - `driving_courses` unknown[], required: Driving courses (cursos viales), passed through from the source.
      - unknown

## Other responses

- `202`: Accepted — the result is being computed asynchronously. Poll `job.status_url` (GET /jobs/{id}) or supply `callback_url` to have the result POSTed to you. Returned when `Prefer: wait` elapses before completion, or immediately when `callback_url` is set.
- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)