Bogotá — Taxe véhicule

Endpoint

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

Donne les obligations fiscales d’un véhicule immatriculé à Bogotá. Indiquez le type et le numéro du document du propriétaire (documentType, documentNumber) et la plaque (plate) en paramètres de requête. La réponse inclut le détail du véhicule et le statut des obligations par exercice.

En-têtes (Headers)

Nom	Valeur
Accept	application/json
Authorization	Bearer <token>

Paramètres

Nom	Type	Requis	Description
plate	string	Oui	Plaque d’immatriculation, sans espaces ni points.
documentNumber	string	Oui	Numéro de document, sans espaces ni points.
documentType	string	Oui	Type de document autorisé : CC ou NIT.

Requête (Request)

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/bogota/vehicle/tax", {
  params: { 
    plate: "ABC123", 
    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/bogota/vehicle/tax"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"plate": "ABC123", "documentType": "CC", "documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Réponse (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"
        }
      ]
    },
    "plate": "ABC123"
  },
  "signature": {"message": "Certified by Verifik.co", "dateTime": "July 3, 2024 3:59 PM"},
  "id": "5P20N"
}

400

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

409

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

Remarques

• CC = carte d’identité colombienne ; NIT = numéro d’identification fiscale (entreprise ou particulier assujetti).
• Si obligationStatus vaut Moroso, des impôts restent dus.