Documentação da API
Integre consultas veiculares e documentos da ZapCar ao seu sistema por uma API REST: você envia a placa (ou o identificador que o serviço pede) e recebe o resultado em JSON e PDF.
https://api.zapcarconsulta.com.brVou programar a integração
Leia a referência, copie os exemplos prontos e teste no sandbox. Tudo gerado do contrato oficial.
Vou integrar com inteligência artificial
Escolha a ferramenta (Claude Code, ChatGPT, Cursor, Lovable, Bolt, Windsurf), copie o prompt e deixe a IA implementar no seu projeto.
Início rápido
Seis etapas da conta à produção. Nenhuma exige login para ler a documentação.
0 de 6 etapas
Etapa 1: Criar conta ZapCar
Grátis e sem mensalidade. A mesma conta serve ao Portal, ao Telegram e à API.
Etapa 2: Gerar chave de teste
Em Conta › Integrações, clique em Chave de teste. O valor zc_test_ aparece uma vez só.
Etapa 3: Escolher a tecnologia ou a IA
Vai programar? Escolha a linguagem. Usa IA? Escolha a ferramenta.
Etapa 4: Copiar o código ou o prompt
Comece pelo cliente (Autenticação) ou pelo prompt da sua ferramenta.
Etapa 5: Testar no sandbox
Placas TST0001, TST0404, TST0503 e TST9999 cobrem sucesso, erro e espera. Nada é cobrado.
Etapa 6: Preparar a produção
Chave zc_live_, saldo na carteira, Idempotency-Key e monitoramento.
Clique no número para marcar a etapa. O progresso fica só neste navegador.
Atalhos
Como a API funciona
É uma API REST comum: chamadas HTTPS com corpo JSON (UTF-8) e respostas em JSON. Não há SDK obrigatório: qualquer linguagem que faça requisições HTTP serve. As datas vêm no fuso America/São_Paulo.
A consulta depende de fontes externas e leva de alguns segundos a alguns minutos. Por isso ela é assíncrona: você cria a consulta, recebe um id e busca o resultado depois (por polling ou por webhook). As exceções são os dois endpoints de FIPE, que respondem na mesma chamada.
Debita o saldo e devolve o id
A base é consultada. Segundos, ou até ~2 min numa placa fria.
dados, veiculo e pdf_url
Valor estornado. Leia retryable.
| Item | Como é |
|---|---|
| Autenticação | Chave no cabeçalho Authorization: Bearer. Detalhes |
| Ambientes | A mesma URL para teste e produção: quem decide é a chave (zc_test_ ou zc_live_). Sandbox |
| Cobrança | Pré-paga, pelo saldo da carteira. O débito acontece na criação da consulta e é estornado automaticamente quando ela falha. Regras |
| Retry seguro | Cabeçalho Idempotency-Key nos endpoints que cobram. Idempotência |
| Erros | Envelope único com codigo, retryable e request_id. Tratamento de erros |
| Contrato | Versão /v1 na URL e schema_version no corpo da resposta. Versionamento |
| Especificação | OpenAPI 3.0 e coleção Postman gerados do catálogo vigente. Baixar |
Endpoints
O que você recebe
A maioria dos serviços entrega dados em JSON e um PDF pronto. A Consulta Simples e a família da Consulta Completa vêm estruturadas por seção; gravame, RENAJUD, débitos, decodificações e as consultas de pessoa vêm no formato da fonte; CRLV, 2ª via do ATPV-e e código de segurança saem só como documento. Nos serviços de veículo há também o bloco veiculo, normalizado pela ZapCar, que mantém a mesma forma quando a fonte muda.