Sign In

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.