Sign In

Consulta Veicular — Completa

Last updated

Retorna identificação do veículo, dados do proprietário, registro, indicadores e referências FIPE com histórico mensal, conforme disponibilidade.

Os dados provêm de fornecedores terceiros e podem estar incompletos, desatualizados ou incorretos. Um indicador false reflete o retorno das bases consultadas e não garante a ausência da condição indicada.

Propriedade Valor
Dataset veicular_completa
Método e caminho POST /datasets/veicular_completa/queries
Versão do schema de dados (schema_version) 1.0.0
Entrada Placa
Consultas em lote Suportadas, conforme disponibilidade no catálogo
Indisponibilidade diária Das 23h às 03h, horário de Brasília (America/Sao_Paulo), para novas consultas e lotes.

Requisição

curl --request POST 'https://api.verifica-online.com.br/datasets/veicular_completa/queries' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: veicular-completa-exemplo-001' \
  --data '{"plate":"ABC1D23"}'
{
  "plate": "ABC1D23"
}

<API_KEY> representa uma chave válida da conta. Placas, proprietário, veículo e valores são ilustrativos, sem vínculo declarado com um veículo real.

Entrada e disponibilidade

Campo Tipo Obrigatório Regra
plate string Sim Placa brasileira ABC1234 ou ABC1D23. Espaços e hífens são removidos e letras são convertidas para maiúsculas. A entrada pode ter até 30 caracteres; a placa normalizada deve ter sete.

O corpo aceita somente plate; campos adicionais e valores numéricos são rejeitados. A chave de idempotência, quando enviada, aceita de 8 a 128 caracteres de A–Z, a–z, 0–9, _, ., :, -; consulte requisições e cobrança.

Novas consultas deste dataset ficam indisponíveis diariamente das 23h, inclusive, às 03h, exclusive, no fuso America/Sao_Paulo — horário de Brasília. Verifique disponibilidade e preço efetivo da conta em GET /datasets. A recuperação de uma operação já criada segue seu prazo de retenção e as regras de resultados.

Dados de resposta

Exemplo completo do campo data:

{
  "owner": {
    "name": "Proprietário de Exemplo",
    "document": "11222333000181",
    "document_type": "CNPJ"
  },
  "vehicle": {
    "plate": "ABC1D23",
    "alternative_plate": "ABC1234",
    "state": "SP",
    "city": "Cidade Exemplo",
    "brand": "Marca Exemplo",
    "model": "Modelo Exemplo",
    "submodel": "Hatch",
    "version": "1.0",
    "model_year": "2022",
    "manufacture_year": "2021",
    "renavam": "00000000000",
    "chassis": "CHASSI-DE-EXEMPLO",
    "color": "Branco",
    "fuel": "Flex",
    "engine_number": "MOTOR-EXEMPLO",
    "gearbox_number": "",
    "type": "Automóvel",
    "kind": "Passageiro",
    "body_type": "Hatch",
    "origin": "Nacional",
    "displacement_cc": "1000",
    "axle_count": "2",
    "total_gross_weight": "",
    "max_traction_capacity": "",
    "passenger_capacity": "5",
    "segment": "Automóvel",
    "subsegment": "Hatch",
    "line": "",
    "group": "",
    "assembly_type": "",
    "body_number": "",
    "rear_axle_number": "",
    "auxiliary_axle_number": "",
    "status": "Em circulação",
    "category": "Particular",
    "max_load_capacity": "",
    "power": 80
  },
  "registration": {
    "exercise_year": "2025",
    "crlv_issued_at": "2025-03-10",
    "crv_issued_at": "2021-08-20",
    "chassis_remarked": false,
    "chassis_remark_description": ""
  },
  "invoiced": {
    "document": "",
    "document_type": "",
    "state": ""
  },
  "importation": null,
  "indicators": {
    "renainf": false,
    "sale_communication": false,
    "issuance_pending": false,
    "renajud": false,
    "rfb": null,
    "theft": false,
    "auction": null,
    "alarm": false,
    "siniav": null,
    "recall": false
  },
  "fipe_candidates": [
    {
      "model_year": "2022",
      "manufacture_year": "2021",
      "fipe_code": "000000-0",
      "fuel": "flex",
      "reference_month": "junho de 2025",
      "brand": "Marca Exemplo",
      "model": "Modelo Exemplo 1.0",
      "category": "Carros",
      "score": 95,
      "value_cents": 6500000,
      "primary": true,
      "history": [
        { "month": "2025-06", "value_cents": 6500000 },
        { "month": "2025-05", "value_cents": 6550000 }
      ]
    }
  ]
}

Todos os campos são presentes nos objetos correspondentes. Blocos desconhecidos podem retornar null; strings não nulas sem informação podem retornar "". Os booleanos nulos representam informação desconhecida, e não false. Identificadores, anos, capacidades e cilindrada são strings. Os valores com sufixo _cents são centavos de BRL. As datas de registro e importação são YYYY-MM-DD, mesmo quando o nome termina em _at.

Blocos e veículo

Campo em data Tipo Nulo Descrição
owner object Sim Proprietário disponível.
owner.name string Não Nome ou razão social.
owner.document string Não Documento sem pontuação ou espaços e com letras em maiúsculas, quando informado.
owner.document_type string Não Tipo de documento informado, sem enumeração fechada.
vehicle object Sim Cadastro e características do veículo.
vehicle.plate string Não Placa principal em maiúsculas.
vehicle.alternative_plate string Não Outra placa conhecida para a mesma identificação.
vehicle.state string Não UF do cadastro.
vehicle.city string Não Município do cadastro.
vehicle.brand string Não Marca.
vehicle.model string Não Modelo.
vehicle.submodel string Não Submodelo.
vehicle.version string Não Versão.
vehicle.model_year string Não Ano-modelo.
vehicle.manufacture_year string Não Ano de fabricação.
vehicle.renavam string Não RENAVAM, preservado como texto.
vehicle.chassis string Não Chassi.
vehicle.color string Não Cor.
vehicle.fuel string Não Combustível informado no cadastro.
vehicle.engine_number string Não Número do motor.
vehicle.gearbox_number string Não Número do câmbio.
vehicle.type string Não Tipo de veículo.
vehicle.kind string Não Espécie do veículo.
vehicle.body_type string Não Tipo de carroceria.
vehicle.origin string Não Procedência.
vehicle.displacement_cc string Não Cilindrada informada, preservada como texto.
vehicle.axle_count string Não Quantidade de eixos como texto.
vehicle.total_gross_weight string Não Peso bruto total como informado; unidade não especificada pelo contrato.
vehicle.max_traction_capacity string Não Capacidade máxima de tração como informada; unidade não especificada pelo contrato.
vehicle.passenger_capacity string Não Capacidade de passageiros como texto.
vehicle.segment string Não Segmento.
vehicle.subsegment string Não Subsegmento.
vehicle.line string Não Linha.
vehicle.group string Não Grupo.
vehicle.assembly_type string Não Tipo de montagem.
vehicle.body_number string Não Número da carroceria.
vehicle.rear_axle_number string Não Número do eixo traseiro.
vehicle.auxiliary_axle_number string Não Número do eixo auxiliar.
vehicle.status string Não Situação do veículo.
vehicle.category string Não Categoria.
vehicle.max_load_capacity string Não Capacidade máxima de carga como informada; unidade não especificada pelo contrato.
vehicle.power integer Sim Potência informada; unidade não especificada pelo contrato.

Registro, faturamento, importação e indicadores

Campo em data Tipo Nulo Descrição
registration object Sim Informações de registro.
registration.exercise_year string Não Ano do exercício.
registration.crlv_issued_at string Sim Data de emissão do CRLV, em YYYY-MM-DD.
registration.crv_issued_at string Sim Data de emissão do CRV, em YYYY-MM-DD.
registration.chassis_remarked boolean Sim Indicação conhecida de remarcação de chassi.
registration.chassis_remark_description string Não Descrição da remarcação.
invoiced object Sim Informações de faturamento.
invoiced.document string Não Documento de faturamento sem pontuação ou espaços, com letras em maiúsculas.
invoiced.document_type string Não Tipo de documento de faturamento.
invoiced.state string Não UF de faturamento.
importation object Sim Informações de importação.
importation.declaration_number string Não Número da declaração.
importation.declared_at string Sim Data da declaração, em YYYY-MM-DD.
importation.document_type string Não Tipo de documento da importadora.
indicators object Sim Indicadores disponíveis. Cada valor pode ser desconhecido.
indicators.renainf boolean Sim Indicador RENAINF.
indicators.sale_communication boolean Sim Comunicação de venda.
indicators.issuance_pending boolean Sim Pendência de emissão.
indicators.renajud boolean Sim Indicador RENAJUD.
indicators.rfb boolean Sim Indicador RFB.
indicators.theft boolean Sim Indicador de roubo ou furto.
indicators.auction boolean Sim Indicador de leilão.
indicators.alarm boolean Sim Indicador de alarme.
indicators.siniav boolean Sim Indicador SINIAV.
indicators.recall boolean Sim Indicador de recall.

Referências FIPE

Campo em data Tipo Nulo Descrição
fipe_candidates array de object Não Referências FIPE disponíveis, até 1.000; pode estar vazia.
fipe_candidates[].model_year string Não Ano-modelo com quatro dígitos.
fipe_candidates[].manufacture_year string Não Ano de fabricação disponível.
fipe_candidates[].fipe_code string Não Código no formato de seis dígitos, hífen e um dígito.
fipe_candidates[].fuel string Não Combustível em minúsculas; variantes equivalentes de flex são apresentadas como flex.
fipe_candidates[].reference_month string Não Mês de referência textual, sem formato fixado pelo contrato.
fipe_candidates[].brand string Não Marca do candidato.
fipe_candidates[].model string Não Modelo do candidato.
fipe_candidates[].category string Não Categoria disponível.
fipe_candidates[].score integer Sim Pontuação de associação do candidato, não de crédito.
fipe_candidates[].value_cents integer Sim Valor de referência em centavos de BRL.
fipe_candidates[].primary boolean Sim Indicação de candidato principal, quando conhecida.
fipe_candidates[].history array de object Não Histórico disponível, até 1.000 meses por candidato.
fipe_candidates[].history[].month string Não Mês no formato YYYY-MM, com mês de 01 a 12.
fipe_candidates[].history[].value_cents integer Não Valor do mês em centavos de BRL, maior ou igual a zero.

Referências com o mesmo código FIPE, ano-modelo e combustível são reunidas. Os candidatos principais aparecem primeiro; dentro de cada grupo, o score de associação é ordenado de forma decrescente. O histórico possui meses únicos, em ordem decrescente; pode estar vazio. A presença de candidatos não garante uma única referência FIPE correta para o veículo.

Ausência de dados, falhas e cobrança

O preenchimento de cada grupo depende das informações disponíveis em um resultado válido. Informações desconhecidas seguem as regras de nulabilidade e de listas descritas nas tabelas acima. Valores false e zero são valores válidos retornados pela fonte. Campos nulos ou listas vazias não bastam para classificar a consulta como no_data.

Se parte da execução falhar e houver dados úteis disponíveis, eles são entregues com status: "partial", mantendo o schema. Consulte os descontos. Sem dados úteis e com falha, o estado é failed; essa falha não indica ausência de veículo. Resultados no_data e failed não são cobrados.

Um resultado válido com dados e sem falhas retorna status: "succeeded" e é cobrado pelo preço efetivo da conta. Consulte GET /datasets para preço e disponibilidade.

Este dataset suporta consultas em lote quando batch.enabled está habilitado no catálogo da conta. Cada entrada utiliza este mesmo contrato de dados. A restrição de horário aplica-se à criação de novos lotes. Os itens de lotes já aceitos podem ser processados durante a janela de indisponibilidade.

Consulte também autenticação, envelope e recuperação dos resultados e erros.