SIMIT — Requête générale par pièce d'identité

Point d'accès

https://api.verifik.co/v2/co/simit/consultar

Ce service permet d'accéder aux contraventions et amendes routières associées à un numéro de document en Colombie. The response includes comprehensive details about each traffic ticket, such as the type of violation, the amount of the fine, and the current status of the ticket.

En-têtes

Nom	Valeur
Accept	application/json
Authorization	Bearer <token>

Paramètres

Nom	Type	Requis	Description
documentType	string	Oui	Document type. Valid parameters: CC, PA, CE, TI, RC, NIT.
documentNumber	string	Oui	Numéro de document à consulter, sans espaces ni points.

Requête

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/simit/consultar", {
  params: { 
    documentType: "CC", 
    documentNumber: "123456789" 
  },
  headers: { 
    Accept: "application/json", 
    Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` 
  },
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/simit/consultar"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CC", "documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Réponse

200

{
  "value": {
    "value": {
      "data": {
        "multas": [
          {
            "infractor": {
              "tipoDocumento": "Cédula",
              "numeroDocumento": "123456789",
              "nombre": "C**",
              "apellido": "B**",
              "idTipoDocumento": 1
            },
            "valor": 344730,
            "placa": "RDL805",
            "infracciones": [
              {
                "codigoInfraccion": "C35",
                "descripcionInfraccion": "No realizar la revisión técnico-mecánica en el plazo legal establecido o cuando el vehiculo no se encuentre en adecuadas condiciones técnico-mecánicas o de emisión de gases, aun cuando porte los certificados correspondientes.",
                "valorInfraccion": 344730
              }
            ],
            "valorPagar": 344730,
            "departamento": "Cundinamarca",
            "organismoTransito": "Ricaurte",
            "fechaComparendo": "23/02/2016 00:00:00",
            "fechaResolucion": "12/12/2022",
            "numeroComparendo": "25612001000012662173",
            "estadoComparendo": "Pendiente"
          }
        ],
        "cursos": [
          {
            "numeroMulta": "00001234",
            "fechaCurso": "21/12/2011",
            "numeroCurso": "60462",
            "ciudadRealizacion": "Medellin",
            "centroInstruccion": "CIA AL INFRACTOR DE TRANSITO",
            "estado": "No aplicado",
            "certificado": "60462"
          }
        ],
        "acuerdosPago": [
          {
            "resolucion": "324",
            "fechaResolucion": "16/02/2018",
            "estado": "Acuerdo de pago",
            "valorAcuerdo": 837716,
            "pendiente": 837716,
            "totalPagar": 837716,
            "secretaria": "Jamundi",
            "departamento": "Valle del Cauca"
          }
        ],
        "totalMultasPagar": 31,
        "cantMultasPagar": 0,
        "totalAcuerdosPagar": 11,
        "cantAcuerdosPagar": 0
      },
      "signature": {"message": "Certified by Verifik.co", "dateTime": "August 31, 2022 4:16 PM"}
    }
  }
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

409

{
  "code": "MissingParameter",
  "message": "missing documentType. missing documentNumber"
}

Notes

• Service complet SIMIT : amendes, cours et accords de paiement pour une personne.
• "Multas" contains traffic violation details with infraction codes and descriptions.
• "Cursos" shows traffic education courses taken by the person.
• "AcuerdosPago" displays payment agreements for outstanding fines.
• Amounts are provided in Colombian Pesos (COP).