Histórico de Proprietários

Proprietários anteriores do veículo: nome, CPF/CNPJ, ano de exercício, município e UF de cada registro de titularidade.

historico-proprietariosJSONPDFR$ 15,60

Resumo

Item	Valor
Identificador técnico	`historico-proprietarios`
Dados exigidos	placa (no catálogo: `placa`)
O que devolve	JSON com a cadeia de titularidade (proprietarios[], um item por registro, do mais recente para o mais antigo) + PDF
Preço vigente	R$ 15,60. Com a sua chave, `GET /v1/servicos` traz o seu preço.
Prazo	Poucos minutos; pode variar conforme a base de titularidade.
Bloco veiculo	Não
Observação	Contém dados pessoais de terceiros (donos anteriores): use apenas para a finalidade da consulta e não redistribua.

Requisição

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

cURLPOST /v1/consultas (historico-proprietarios)

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-historico-proprietarios" \
  -d '{"servico":"historico-proprietarios","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:

status	O que vem
processando	Só o envelope. Consulte de novo em 3 a 5 s.
concluido	`dados` e `pdf_url`.
erro	Valor estornado. `erro_codigo` diz o motivo e `retryable` se vale criar uma consulta nova.

Campo dados

No formato da base consultada (camada de espelho): nomes e preenchimento acompanham a fonte. Para dado com forma garantida, use o bloco veiculo quando o serviço tiver.

JSONExemplo ilustrativo: campo dados (historico-proprietarios)

{
  "placa": "ABC1D23",
  "chassi": "9BWZZZ377VT004251",
  "ano_fabricacao": "2019",
  "proprietarios": [
    {
      "ocorrencia": "TRANSFERENCIA DE PROPRIEDADE",
      "uf": "SP",
      "codigo_municipio": "7107",
      "municipio": "SAO PAULO",
      "ano_exercicio": "2023",
      "placa": "ABC1D23",
      "chassi": "9BWZZZ377VT004251",
      "cgc_cpf": "12345678909",
      "nome_proprietario": "FULANO DE TAL",
      "tipo_documento": "CPF",
      "correcao_chassi_renavam": "N",
      "data_processamento": "2023-04-12",
      "hora_processamento": "10:32:00",
      "motivo_tipo_autorizacao": "TRANSFERENCIA"
    },
    {
      "ocorrencia": "PRIMEIRO EMPLACAMENTO",
      "uf": "SP",
      "codigo_municipio": "7107",
      "municipio": "SAO PAULO",
      "ano_exercicio": "2019",
      "placa": "ABC1D23",
      "chassi": "9BWZZZ377VT004251",
      "cgc_cpf": "12345678000199",
      "nome_proprietario": "CONCESSIONARIA EXEMPLO LTDA",
      "tipo_documento": "CNPJ",
      "correcao_chassi_renavam": "N",
      "data_processamento": "2019-02-08",
      "hora_processamento": "15:04:00",
      "motivo_tipo_autorizacao": "EMPLACAMENTO"
    }
  ]
}

Particularidades

dados.proprietarios[] traz um item por registro de titularidade, do mais recente para o mais antigo.
Contém dado pessoal de terceiros (donos anteriores): use só para a finalidade da consulta e não redistribua.

No sandbox

Cenários de erro e de espera pela placa (TST0404 não encontrado, TST0503 falha retentável, TST9999 nunca conclui); qualquer outra placa conclui. Como em produção, a resposta não traz bloco veiculo; dados vem 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.