Pular para o conteúdo
ZapCar
Developersv1

Consulta Veicular

Dados cadastrais, proprietário, restrições, gravame e leilão pela placa. Débitos quando a base informa.

consulta-veicularJSONPDFR$ 24,99

Resumo

ItemValor
Identificador técnicoconsulta-veicular
Dados exigidosplaca (no catálogo: placa)
O que devolveJSON estruturado no formato da Consulta Completa, sem os blocos exclusivos dela (historicoKm, historicoProprietarios, rouboFurto, csv, blocos); debitos costuma vir null (não verificado) + PDF
Preço vigenteR$ 24,99. Com a sua chave, GET /v1/servicos traz o seu preço.
PrazoCostuma ficar pronta em poucos minutos; a base pode segurar a resposta até concluir a consulta.
Bloco veiculoSim (contrato normalizado da ZapCar)

Requisição

Pelo endpoint comum de consultas, POST /v1/consultas. Os valores do exemplo são fictícios.

cURLPOST /v1/consultas (consulta-veicular)
curl -X POST "https://api.zapcarconsulta.com.br/v1/consultas" \
  -H "Authorization: Bearer $ZAPCAR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-erp-984281-consulta-veicular" \
  -d '{"servico":"consulta-veicular","placa":"ABC1D23"}'

Resposta

O POST devolve 201 com o id e status: "processando". O resultado sai em GET /v1/consultas/{id}, que passa por um destes estados:

statusO que vem
processandoSó o envelope. Consulte de novo em 3 a 5 s.
concluidodados, veiculo, risco e pdf_url.
erroValor estornado. erro_codigo diz o motivo e retryable se vale criar uma consulta nova.

Campo dados

Estruturado por seção, no contrato da família da Consulta Completa.

JSONExemplo ilustrativo: campo dados (consulta-veicular)
{
  "placa": "ABC1D23",
  "chassi": "9BWZZZ377VT004251",
  "numeroMotor": "CSS123456",
  "ufPlaca": "SP",
  "municipioPlaca": "SAO PAULO",
  "renavam": "00987495364",
  "status": "EM CIRCULACAO",
  "anoFabricacao": 2020,
  "anoModelo": 2021,
  "marcaModelo": "VW/GOL 1.0L MC4",
  "tipoVeiculo": "AUTOMOVEL",
  "especie": "PASSAGEIRO",
  "cor": "PRATA",
  "combustivel": "ALCOOL/GASOLINA",
  "categoria": "PARTICULAR",
  "potencia": 84,
  "cilindrada": 999,
  "situacaoLicenciamento": "LICENCIADO",
  "licenciadoAte": "2025",
  "anoUltimoLicenciamento": 2025,
  "ativo": "SIM",
  "codigoMarcaModelo": "0123456",
  "quantidadeEixos": 2,
  "capacidadePassageiros": 5,
  "capacidadeCargaKg": null,
  "pesoBrutoTotal": null,
  "capacidadeMaximaTracao": null,
  "capacidadeTanqueLitros": null,
  "numeroDocumentoFaturado": "12345678000190",
  "ufFaturamento": "SP",
  "proprietario": {
    "nome": "JOAO DA SILVA",
    "nomeLegal": null,
    "documento": "12345678901",
    "tipoDocumento": "CPF",
    "nomeMae": null,
    "nomePai": null,
    "situacao": "REGULAR",
    "porte": null,
    "naturezaJuridicaCodigo": null,
    "naturezaJuridicaDescricao": null,
    "telefones": [],
    "emails": [],
    "enderecos": []
  },
  "restricoes": {
    "restricaoRenainf": false,
    "restricaoRenajud": false,
    "restricaoRfb": false,
    "restricaoAdministrativa": false,
    "rouboOuFurto": false,
    "sinistro": false,
    "recall": false,
    "anuncioVenda": false,
    "intencaoVenda": false,
    "restricao1": null,
    "restricao2": null,
    "restricao3": null,
    "restricao4": null,
    "ocorrencia": null,
    "restricaoGeral": null,
    "veiculoBaixado": null
  },
  "gravames": [
    {
      "numeroRestricao": "1",
      "dataRestricao": "2021-03-10",
      "ufRestricao": "SP",
      "status": "ATIVO",
      "nomeAgente": "BANCO EXEMPLO S.A.",
      "documentoAgente": "00000000000191",
      "dataContrato": "2021-03-05",
      "ufContrato": "SP",
      "numeroContrato": "000123456",
      "documentoFinanciado": "12345678901",
      "nomeFinanciado": "JOAO DA SILVA"
    }
  ],
  "chassiRemarcado": false,
  "tipoDocumentoFaturado": "CNPJ",
  "procedencia": "NACIONAL",
  "requestId": "a1b2c3d4",
  "leilao": {
    "baseDisponivel": true,
    "marcaModelo": null,
    "anoModelo": null,
    "anoFabricacao": null,
    "placa": null,
    "chassi": null,
    "renavam": null,
    "score": null,
    "ocorrencias": []
  },
  "debitos": null,
  "fotosLeilao": null
}
Informação:
O bloco veiculo é o mesmo em todos os serviços que o têm. Ver o exemplo completo em Resultados e os campos no dicionário.

Particularidades

  • Formato de dados da consulta-completa, sem os blocos exclusivos dela (historicoKm, historicoProprietarios, rouboFurto, csv, blocos).
  • debitos costuma vir null: não verificado, diferente de "não deve".

No sandbox

Cenário escolhido pela placa (TST0001 limpo, TST0002 gravame, TST0003 RENAJUD, TST0004 débitos, TST0005 sinistro e leilão, TST0404 não encontrado, TST0503 falha retentável, TST9999 nunca conclui). Bloco veiculo fiel ao contrato; dados reduzido e marcado com _sandbox.

Cobrança

Debitado no POST, antes do processamento, e estornado automaticamente se a consulta terminar em erro. Pedido recusado na validação (400, 402, 409, 422) não cobra. Ler o resultado e baixar o documento são gratuitos. Ver Cobrança e estorno.

Testar no sandbox: abrir no API Explorer. Base da API: https://api.zapcarconsulta.com.br.