Bogotá — Imposto veículo

Endpoint

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

Retorna informações sobre obrigações tributárias de um veículo registrado em Bogotá. Envie o tipo e o número do documento do proprietário (documentType, documentNumber) e a placa (plate) como parâmetros de consulta. A resposta inclui dados do veículo e o estado das obrigações por ano fiscal.

Cabeçalhos

Nome	Valor
Accept	application/json
Authorization	Bearer <token>

Parâmetros

Nome	Tipo	Obrigatório	Descrição
plate	string	Sim	Placa a consultar, sem espaços nem pontos.
documentNumber	string	Sim	Número do documento, sem espaços nem pontos.
documentType	string	Sim	Tipo de documento. Permitidos: CC, NIT.

Requisição

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())

Resposta

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"
}

Notas

• Use CC para cédula de cidadania colombiana ou NIT para identificação tributária.
• Se obligationStatus for Moroso, há tributos em atraso a pagar.