🇨🇴Taxes in Bogota

Service to check if a vehicle has any debt with the Bogotá mobility service.

Taxes in Bogota

GET - https://api.verifik.co/v2/co/bogota/vehicle/tax

This service provides information about the tax obligations for a vehicle registered in Bogotá. To access the details, you need to provide the owner's document type and number, along with the vehicle's license plate. The response includes information such as the vehicle's brand, model, and year, as well as the status of tax obligations for specific fiscal years. If the status is Moroso, it indicates that there are outstanding taxes that need to be paid.

Implementation

Headers

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

Query Parameters

Name	Type	Required?	Description	Example
plate	String	True	Plate to consult, without spaces or points.	ABC123
documentNumber	String	True	Document number to consult, without space or points.	123456789
documentType	String	True	Document type. Allowed parameters: CC, NIT.	CC

Request

JavaScript

import axios from 'axios';

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

try {
  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/bogota/vehicle/tax?documentType=&documentNumber=&plate=", 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/bogota/vehicle/tax?documentType=&documentNumber=&plate=")!,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/bogota/vehicle/tax?documentType=&documentNumber=&plate=');
$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": {
        "details": "",
        "documentNumber": "123456789",
        "documentType": "CC",
        "obligation": {
            "vehicle": [
                {
                    "brand": "MAZDA",
                    "form": "2020003010100010240",
                    "linea": "050365",
                    "model": "2021",
                    "obligation": "1.080.000",
                    "obligationStatus": "Moroso",
                    "plate": "ABC123",
                    "reference": "0000020034588543",
                    "taxableYear": "2020",
                    "totalToPay": "1.080.000"
                },
                {
                    "brand": "MAZDA",
                    "form": "2021203041643246796",
                    "linea": "050365",
                    "model": "2021",
                    "obligation": "3.459.000",
                    "obligationStatus": "Moroso",
                    "plate": "JMU866",
                    "reference": "0000021037595180",
                    "taxableYear": "2021",
                    "totalToPay": "3.459.000"
                }
            ]
        },
        "plate": "JMU866"
    },
    "signature": {
        "dateTime": "July 3, 2024 3:59 PM",
        "message": "Certified by Verifik.co"
    },
    "id": "5P20N"
}

400

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

409

{
"code": "MissingParameter",
"message": "missing plate\n"
}

409

{
"code": "MissingParameter",
"message": "documentType must be one of: [CC,NIT]"
}