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.