Integre consultas veiculares ao seu sistema.
API REST para ERPs, DMS, marketplaces, softwares de despachante e aplicativos. Consulta pela placa, gravame, RENAJUD, débitos e documentos, com resposta em JSON e PDF e cobrança no saldo da conta.
A chave é criada por você no painel, sem aprovação. A chave de teste roda no sandbox sem gastar saldo. Criar conta grátis · Precisa de homologação assistida?
# 1 · Crie a consulta: debita o saldo e devolve um id
curl -X POST https://api.zapcarconsulta.com.br/v1/consultas \
-H "Authorization: Bearer zc_live_sua_chave" \
-H "Idempotency-Key: pedido-erp-984281" \
-H "Content-Type: application/json" \
-d '{ "servico": "consulta-completa", "placa": "ABC1D23" }'
# → 201 Created
{ "id": "6f1c2e2a-…", "status": "processando", "valor_cobrado": 34.99 }
# 2 · Busque o resultado até status = "concluido" (ou receba por webhook)
curl https://api.zapcarconsulta.com.br/v1/consultas/6f1c2e2a-… \
-H "Authorization: Bearer zc_live_sua_chave"
# → 200 OK
{
"status": "concluido",
"dados": {
"marcaModelo": "VW/NIVUS HIGHLINE TSI",
"anoFabricacao": 2022,
"restricoes": { "rouboOuFurto": false, "sinistro": false, "restricaoRenajud": false },
"historicoKm": { "inconsistente": false, "registros": [ … ] }
},
"pdf_url": "/v1/consultas/6f1c2e2a-…/pdf"
}- Base URL
- https://api.zapcarconsulta.com.br/v1
- Autenticação
- Authorization: Bearer zc_live_…
Exemplos em cURL, JavaScript, PHP e Python na documentação. Também: OpenAPI (JSON) e coleção do Postman.
Do teste à produção em três etapas.
Sem cadastro manual nem espera por liberação. É a mesma estrutura que atende o Portal do Cliente.
- 01
Homologação
Crie a conta, gere uma chave de teste (zc_test_) e simule cenários por placa no sandbox, sem gastar saldo.
Testar no sandbox - 02
Integração
Chame POST /v1/consultas, receba o resultado por webhook assinado ou consulte o status. OpenAPI e Postman prontos.
Ver documentação - 03
Produção
Troque pela chave zc_live_, recarregue saldo por PIX e acompanhe consumo e histórico no Portal do Cliente.
Primeiros passos
O que a API oferece.
Cada item abaixo existe na API em produção e tem uma seção própria na documentação.
Passo 1: Seu sistema
- ERP, DMS, marketplace ou aplicativo
- Envia o serviço e a placa
Passo 2: API ZapCar
- Recebe o pedido com a chave da sua conta
- Consulta as bases e debita o mesmo saldo do Portal
Passo 3: Resultado
- Dados em JSON e o PDF
- Aviso por webhook quando termina
- Também no histórico do Portal
REST + JSON
Endpoints sobre HTTPS com resposta em JSON estruturado. Você lê os campos direto, sem extrair texto de PDF.
Ver na documentaçãoAutenticação por Bearer
Chave zc_live_ gerada por você em Conta › Integrações, revogável a qualquer momento. O cabeçalho X-API-Key também é aceito.
Ver na documentaçãoSandbox
Chave zc_test_ com cenários por placa (TST0001, TST0404…) e ambiente:"test" em toda resposta.
Ver na documentaçãoWebhooks assinados
query.completed e query.failed com HMAC-SHA256, até 6 tentativas com backoff a partir de 10s e histórico de entregas.
Ver na documentaçãoIdempotência
Cabeçalho Idempotency-Key: um retry de rede devolve a resposta original sem criar consulta nem cobrar de novo.
Ver na documentaçãoCatálogo de erros
Cada erro traz código, mensagem e o campo retryable, para o seu retry saber quando tentar de novo.
Ver na documentaçãoLimite de uso declarado
Até 120 requisições por minuto por conta e por IP (60 com a chave de teste); acima disso, 429 RATE_LIMITED com retryable: true.
Ver na documentaçãoSaldo e consumo
O mesmo saldo do Portal e do Telegram: GET /v1/saldo devolve o valor; consulta que falha é estornada.
Ver na documentaçãoOpenAPI e Postman
Especificação gerada do catálogo e coleção pronta para importar no Swagger, Insomnia ou Postman.
Ver na documentaçãoStatus público
O estado de API, consultas, documentos, processamento e pagamentos, publicado em /status.
Ver na documentaçãoSegurança
HTTPS em todas as rotas; chaves de API guardadas apenas como hash no backend.
Ver na documentaçãoPDF pronto e white-label
GET /v1/consultas/:id/pdf entrega o relatório; nos compatíveis, com a logo da sua conta.
Ver na documentação
Os mesmos serviços do painel.
Escolha o serviço no corpo da requisição de POST /v1/consultas. Os serviços de consulta devolvem dados em JSON; CRLV, 2ª via do ATPV-e e Código de Segurança do CRV chegam em PDF.
- Consulta SimplesMarca, modelo, ano, cor, situação e dados de registro a partir da placa.
- Consulta CompletaGravame, indicador de sinistro, leilão, restrições, débitos e score, o que a base devolver.
- GravameFinanciamento e alienação fiduciária, com os dados do agente financeiro.
- RENAJUDRestrições judiciais registradas sobre o veículo.
- Débitos + Código de BarrasIPVA, multas, licenciamento e DPVAT, com linha digitável quando a base fornece.
- Débitos EstaduaisIPVA, licenciamento, DPVAT e multas na base do estado, nas 27 UFs. Basta a placa e a UF.
- Decodificação de ChassiChassi (sem placa) em marca, modelo, ano e sugestões da Tabela FIPE.
- Decodificação de MotorIdentificação do veículo a partir do número do motor.
- Score de CréditoScore e dados cadastrais por CPF ou CNPJ, com finalidade declarada.
- CRLV DigitalEmissão do Certificado de Registro e Licenciamento do Veículo, em PDF. Pede placa e UF; algumas UFs exigem também CPF/CNPJ e/ou RENAVAM.
- 2ª via do ATPV-eAutorização para transferência, em PDF, com cobertura nacional. Pede a placa e a declaração do usuário sobre o aviso da 2ª via (aceite_atpve).
- Código de Segurança do CRVExigido na transferência do veículo. Pede placa e RENAVAM; entregue em PDF.
Preço por consulta, sem mensalidade mínima.
Os valores da API seguem o catálogo de integrações (GET /v1/servicos) e podem diferir das condições disponíveis no Portal do Cliente. Exemplo: a Tabela FIPE é gratuita no painel e cobrada por requisição na API. Cada chamada debita do saldo o valor vigente do catálogo; consultas que terminam em erro são estornadas automaticamente.
| Serviço | Slug da API | Requer | Por consulta |
|---|---|---|---|
| Consulta Simples | consulta | placa | R$ 5,98 |
| Consulta Completa | consulta-completa | placa | R$ 34,99 |
| Laudo ECV PremiumTraz a cadeia de proprietários com documento: dado pessoal de terceiros. | ecv-premium | placa | R$ 31,99 |
| Consulta Veicular | consulta-veicular | placa | R$ 24,99 |
| Gravame | gravame | placa | R$ 6,99 |
| RENAJUD | renajud | placa | R$ 6,99 |
| Débitos + Código de Barras | debitos | placa | R$ 19,99 |
| Débitos Estaduais | debitos-estadual | placa + uf | R$ 6,99 |
| Histórico de ProprietáriosContém dados pessoais de terceiros (donos anteriores): use apenas para a finalidade da consulta e não redistribua. | historico-proprietarios | placa | R$ 15,60 |
| Detalhe Comunicação de VendaTraz dado pessoal do comprador: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem comunicação registrada, nada é cobrado. | comunicacao-venda | placa | R$ 6,99 |
| Decodificação de Chassi | decodificacao-chassi | chassi | R$ 2,99 |
| Decodificação de Motor | decodificacao-motor | motor | R$ 3,99 |
| Score de CréditoDado de pessoa (CPF/CNPJ): exige finalidade declarada e fica registrado quem consultou, quando e para quê. | score-credito | cpf ou cnpj | R$ 12,99 |
| Situação do CPFDado de pessoa (CPF): exige finalidade declarada e fica registrado quem consultou, quando e para quê. | situacao-cpf | cpf + data de nascimento | R$ 1,99 |
| Cadastro Simples CPFDado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | cadastro-simples-cpf | cpf + finalidade | R$ 4,90 |
| Cadastro Completo CPFDado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | cadastro-completo-cpf | cpf + finalidade | R$ 2,49 |
| Cadastro Simples CNPJDado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | cadastro-simples-cnpj | cnpj + finalidade | R$ 4,90 |
| Cadastro Completo CNPJDado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | cadastro-completo-cnpj | cnpj + finalidade | R$ 9,90 |
| Tabela FIPE: POST /v1/fipeGratuita no painel do cliente. Na API é cobrada por requisição (POST /v1/fipe). | fipe | placa | R$ 0,25 |
| Crédito Único CPFDado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | credito-unico-cpf | cpf + finalidade | R$ 19,99 |
| Crédito Biro CPFDado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | credito-biro-cpf | cpf + uf + finalidade | R$ 36,99 |
| Crédito Único CNPJDado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | credito-unico-cnpj | cnpj + finalidade | R$ 32,99 |
| Crédito Biro CNPJDado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | credito-biro-cnpj | cnpj + uf + finalidade | R$ 58,99 |
| CNH NacionalDado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | cnh-nacional | cpf + cnh + uf + finalidade | R$ 14,90 |
| Débitos Trabalhistas (CNDT)Dado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | debitos-trabalhistas | cpf ou cnpj + finalidade | R$ 9,89 |
| Dívida Ativa da UniãoDado de pessoa: exige finalidade declarada e fica registrado quem consultou, quando e para quê. Sem registro na base, nada é cobrado. | divida-ativa | cpf ou cnpj + finalidade | R$ 7,90 |
| Código de Segurança | codigo-seguranca | placa + renavam | R$ 19,99 |
| 2ª via do ATPV-e | atpve | placa + aceite_atpve | R$ 39,99 |
| Consulta NF-eO retorno traz dados do destinatário da nota: use apenas para a finalidade da consulta e não redistribua. | consulta-nfe | chave de acesso da NF-e | R$ 1,99 |
| CRLV DigitalPreço varia por UF. | crlv | placa + uf | a partir de R$ 26,99 |
Para quem já tem sistema próprio.
A plataforma pronta é o Portal do Cliente; a API é para quem precisa consultar veículos de dentro do próprio software, no volume da operação.
ERPs e DMS
Consulta no fluxo de entrada de veículo do lojista, sem tirar o usuário do seu sistema.
Plataformas automotivas e marketplaces
Dados do veículo e um selo de procedência no momento da publicação do anúncio.
Softwares de despachantes
Documentos e débitos pedidos pelo seu sistema, com o PDF pela própria API.
Aplicativos, fintechs e seguradoras
Gravame e restrições consultados na proposta, para automatizar a análise de risco.
Faça a primeira chamada hoje.
Crie a conta, gere a chave de teste e rode os cenários do sandbox. Para volume ou homologação assistida, fale com a equipe.
Prefere e-mail? Escreva para suporte@zapcarconsulta.com.br.