Consulta Placa
Last updated
Retorna identificação e características do veículo, além dos candidatos FIPE disponíveis para a placa.
| Propriedade | Valor |
|---|---|
| Dataset | consulta_placa |
| Método e caminho | POST /datasets/consulta_placa/queries |
Versão do schema de dados (schema_version) |
1.0.0 |
| Entrada | Placa |
| Consultas em lote | Suportadas, conforme disponibilidade no catálogo |
Requisição
curl --request POST 'https://api.verifica-online.com.br/datasets/consulta_placa/queries' \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: placa-exemplo-001' \
--data '{"plate":"ABC1D23"}'
{
"plate": "ABC1D23"
}
<API_KEY> representa uma chave válida da conta. Placas, veículo e valores são ilustrativos e não indicam vínculo real com a placa de exemplo.
Entrada
| Campo | Tipo | Obrigatório | Regra |
|---|---|---|---|
plate |
string | Sim | Placa brasileira no formato ABC1234 ou ABC1D23. Espaços e hífens são removidos; letras são convertidas para maiúsculas. A string recebida pode ter no máximo 30 caracteres. |
O corpo aceita somente plate; campos adicionais e valores numéricos são rejeitados. Após a normalização, a placa deve ter sete caracteres no padrão de três letras, um dígito, uma letra ou dígito e dois dígitos. 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.
Dados de resposta
Exemplo completo do campo data:
{
"vehicle": {
"plate": "ABC1D23",
"alternative_plate": "ABC1234",
"state": "SP",
"city": "Cidade Exemplo",
"brand": "Marca Exemplo",
"model": "Modelo Exemplo",
"brand_model": "Marca Exemplo/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",
"nationality": "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": "",
"billed_document_type": "",
"importer_document_type": "",
"owner_document_type": "",
"average_price_cents": 6500000
},
"fipe_candidates": [
{
"model_year": "2022",
"fipe_code": "000000-0",
"fuel": "Flex",
"reference_month": "junho de 2025",
"brand": "Marca Exemplo",
"model": "Modelo Exemplo 1.0",
"score": 95,
"value_cents": 6500000
}
]
}
Os objetos incluem todos os campos listados. Strings desconhecidas podem retornar ""; os campos monetários e o score podem retornar null. Anos, identificadores, cilindrada e capacidades são strings, não números. Valores com sufixo _cents são centavos de BRL: 6500000 representa R$ 65.000,00. O mês de referência é texto informativo, sem formato de data fixado pelo contrato.
Campo em data |
Tipo | Nulo | Descrição |
|---|---|---|---|
vehicle |
object | Não | Identificação e características disponíveis. |
vehicle.plate |
string | Não | Placa principal do cadastro, em maiúsculas. |
vehicle.alternative_plate |
string | Não | Placa alternativa disponível; pode corresponder a outro formato da 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.brand_model |
string | Não | Descrição conjunta de marca e 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. |
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.nationality |
string | Não | Nacionalidade informada. |
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.billed_document_type |
string | Não | Tipo do documento de faturamento. |
vehicle.importer_document_type |
string | Não | Tipo do documento da importadora. |
vehicle.owner_document_type |
string | Não | Tipo do documento do proprietário; esta consulta não retorna seu nome ou documento. |
vehicle.average_price_cents |
integer | Sim | Preço médio disponível em centavos de BRL. |
fipe_candidates |
array de object | Não | Candidatos FIPE disponíveis, até 1.000; pode estar vazia. |
fipe_candidates[].model_year |
string | Não | Ano-modelo do candidato. |
fipe_candidates[].fipe_code |
string | Não | Código FIPE informado. |
fipe_candidates[].fuel |
string | Não | Combustível do candidato. |
fipe_candidates[].reference_month |
string | Não | Mês de referência em texto. |
fipe_candidates[].brand |
string | Não | Marca do candidato. |
fipe_candidates[].model |
string | Não | Modelo do candidato. |
fipe_candidates[].score |
integer | Sim | Pontuação de associação do candidato; não é score de crédito. |
fipe_candidates[].value_cents |
integer | Sim | Valor de referência em centavos de BRL. |
Os candidatos com score informado são ordenados por score de associação em ordem decrescente. A lista não representa uma identificação FIPE única garantida. Histórico mensal FIPE, proprietário e indicadores pertencem à Consulta Veicular — Completa.
Ausência de dados, falhas e cobrança
A ausência de veículo encontrado retorna status: "no_data" e data: null, sem cobrança. Uma lista FIPE vazia não elimina os dados válidos do veículo. Respostas inválidas ou divergentes da placa e falhas de execução não são apresentadas como veículo inexistente.
Um resultado válido com dados 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.
Consulte também autenticação, envelope e recuperação dos resultados e erros.