🇨🇴SIMIT Agreements

Service to check agreements in the SIMIT using the offender's data.

SIMIT Agreements

GET - https://api.verifik.co/v2/co/simit/acuerdos

The SIMIT Agreements Service provides an efficient method for retrieving payment agreements related to traffic violations in Colombia's SIMIT system. By querying the service with relevant details, users can obtain a response containing comprehensive information about the agreement.

The response includes details such as the infractor's name, the resolution number, the issuing secretariat, and the total amount due.

This service is particularly useful for developers and organizations that need to automate the retrieval and integration of traffic violation payment agreements into their systems and applications.

Implementation

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Required?	Description	Example
documentType	String	True	Document type. Valid parameters: CC, PA, CE, TI, RC.	CC
documentNumber	String	True	Document number to consult, without spaces or points.	123456789

Request

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/co/simit/acuerdos>',
  params: {documentType: 'CC', documentNumber: '123456789'},
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/co/simit/acuerdos?documentType=CC&documentNumber=", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/co/simit/acuerdos?documentType=CC&documentNumber=")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/co/simit/acuerdos?documentType=CC&documentNumber=');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Response

200

{
  "data": {
    "acuerdosPagos": [
      {
        "estadosResoluciones": "Acuerdo de pago",
        "fechaComparendo": "1900/01/01",
        "fechaResolucion": "2018/07/05",
        "noComparendo": "NO REPORTADO",
        "nombresInfractores": "PEPE SALGADO",
        "permitePago": "N",
        "resoluciones": "0003030",
        "secretarias": "Barrancabermeja",
        "total": "558864.0"
      }
    ],
    "signature": {
      "dateTime": "March 3, 2022 12:11 PM",
      "message": "Certified by Verifik.co"
    }
  }
}

404

{
"code": "NotFound",
"message": "Record not found.",
"signature": {
"dateTime": "August 31, 2022 3:24 PM",
"message": "Certified by Verifik.co"
}
}

409

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