Pular para o conteúdo
ZapCar
Developersv1

Consulta Completa

Relatório da base veicular: restrições, leilão, sinistro, débitos, gravame com agente financeiro e dados cadastrais. Proprietário atual quando disponível.

consulta-completaJSONPDFR$ 38,99

Resumo

ItemValor
Identificador técnicoconsulta-completa
Dados exigidosplaca (no catálogo: placa)
O que devolveJSON estruturado (por seção) + PDF
Preço vigenteR$ 38,99. Com a sua chave, GET /v1/servicos traz o seu preço.
PrazoA maioria das consultas fica pronta em poucos minutos; a base estadual pode levar cerca de 2 minutos na primeira consulta da placa no dia.
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-completa)
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-completa" \
  -d '{"servico":"consulta-completa","placa":"ABC1D23","incluir_fipe":false}'

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-completa)
{
  "placa": "ABC1D23",
  "chassi": "9BWZZZ377VT004251",
  "renavam": "00987495364",
  "marcaModelo": "VW/NIVUS HIGHLINE TSI",
  "anoFabricacao": 2022,
  "anoModelo": 2022,
  "cor": "PRATA",
  "combustivel": "GASOLINA",
  "tipoVeiculo": "AUTOMOVEL",
  "especie": "PASSAGEIRO",
  "categoria": "PARTICULAR",
  "potencia": 128,
  "cilindrada": 999,
  "quantidadeEixos": 2,
  "capacidadePassageiros": 5,
  "procedencia": "NACIONAL",
  "chassiRemarcado": false,
  "situacaoLicenciamento": null,
  "licenciadoAte": null,
  "anoUltimoLicenciamento": 2024,
  "numeroDocumentoFaturado": "12345678901",
  "ufFaturamento": "SP",
  "proprietario": {
    "nome": "JOAO DA SILVA",
    "nomeLegal": null,
    "documento": "12345678901",
    "tipoDocumento": "CPF",
    "situacao": null,
    "telefones": [],
    "emails": [],
    "enderecos": []
  },
  "historicoProprietarios": [
    { "nome": "JOAO DA SILVA", "documento": "12345678901", "anoExercicio": 2024, "uf": "SP" },
    { "nome": "LOCADORA EXEMPLO LTDA", "documento": "12345678000190", "anoExercicio": 2022, "uf": "SP" }
  ],
  "restricoes": {
    "rouboOuFurto": false,
    "sinistro": false,
    "restricaoRenajud": false,
    "restricaoRfb": null,
    "restricaoAdministrativa": false,
    "restricaoRenainf": false,
    "recall": null,
    "intencaoVenda": null,
    "anuncioVenda": null,
    "restricaoGeral": null,
    "veiculoBaixado": false,
    "restricao1": null,
    "restricao2": null,
    "restricao3": null,
    "restricao4": null,
    "ocorrencia": null
  },
  "debitos": {
    "dpvat": 0,
    "ipva": 3821.78,
    "licenciamento": 0,
    "multa": 0,
    "total": 3821.78,
    "estado": {
      "dpvat": "SEM_DEBITO",
      "ipva": "CONSTA",
      "licenciamento": "SEM_DEBITO",
      "multa": "CONSTA_SEM_VALOR"
    },
    "total_parcial": true
  },
  "gravames": [
    {
      "numeroRestricao": "123456", "dataRestricao": "10/01/2022", "ufRestricao": "SP",
      "status": "ATIVO", "nomeAgente": "BANCO EXEMPLO SA", "documentoAgente": "00000000000191",
      "dataContrato": null, "ufContrato": null, "numeroContrato": "C-0001",
      "documentoFinanciado": "12345678901", "nomeFinanciado": "JOAO DA SILVA"
    }
  ],
  "leilao": {
    "baseDisponivel": true,
    "score": { "pontuacao": "C", "descricao": "MEDIA MONTA", "aceitacao": 40, "percentualSobreTabela": 70, "exigeVistoriaEspecial": "SIM" },
    "ocorrencias": [
      { "lote": "1707", "patio": null, "data": "30/05/2023", "comitente": "SEGURADORA EXEMPLO SA",
        "leiloeiro": null, "condicao": "MEDIA MONTA", "observacao": null }
    ]
  },
  "rouboFurto": {
    "constaOcorrencia": true,
    "ocorrenciaAtiva": false,
    "ocorrencias": [
      { "ocorrencia": "Encontrado", "declaracao": null, "data": "21/12/2021", "boletim": "5219", "municipio": "CAMPINAS", "uf": "SP" },
      { "ocorrencia": "Alerta de Roubo/Furto", "declaracao": "Roubo", "data": "19/12/2021", "boletim": "1466", "municipio": "CAMPINAS", "uf": "SP" }
    ]
  },
  "historicoKm": {
    "inconsistente": false,
    "registros": [
      { "km": 18400, "data": "12/03/2022", "dataIso": "2022-03-12" },
      { "km": 39950, "data": "20/06/2023", "dataIso": "2023-06-20" }
    ]
  },
  "fotosLeilao": [
    { "indice": 0, "url": "/v1/consultas/{id}/imagens/leilao/0" },
    { "indice": 1, "url": "/v1/consultas/{id}/imagens/leilao/1" }
  ],
  "csv": [],
  "blocos": {
    "BIN_ESTADUAL":            { "respondeu": true,  "quantidade": 12, "descricao": null },
    "BIN_NACIONAL":            { "respondeu": true,  "quantidade": 0,  "descricao": null },
    "LEILAO":                  { "respondeu": true,  "quantidade": 1,  "descricao": "Consta histórico de leilão" },
    "INDICIO_SINISTRO":        { "respondeu": true,  "quantidade": 0,  "descricao": null },
    "CSV":                     { "respondeu": true,  "quantidade": 0,  "descricao": null },
    "GRAVAME":                 { "respondeu": true,  "quantidade": 1,  "descricao": null },
    "HISTORICO_KM":            { "respondeu": true,  "quantidade": 2,  "descricao": null },
    "ROUBO_FURTO":             { "respondeu": true,  "quantidade": 2,  "descricao": null },
    "HISTORICO_PROPRIETARIOS": { "respondeu": true,  "quantidade": 2,  "descricao": null },
    "IMAGENS_VEICULO":         { "respondeu": true,  "quantidade": 2,  "descricao": null }
  },
  "offline": 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

  • incluir_fipe: true embute a Tabela FIPE em dados.fipe e cobra o adicional informado em opcionais.incluir_fipe.preco_adicional (GET /v1/servicos). Se só a FIPE falhar, só essa parcela é estornada e dados.fipeErro diz o motivo.
  • dados.debitos traz valores reais, estado por item e total_parcial. CONSTA_SEM_VALOR significa "deve, valor não informado": o total é um piso. debitos: null é "não verificado".
  • As fotos de leilão não viajam no JSON: fotosLeilao traz índice e URL de cada uma, servidas por GET /v1/consultas/{id}/imagens/leilao/{indice}.
  • risco é o mesmo índice exibido no painel e no laudo. Não é garantia de compra.

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.