Código de Segurança
Código de segurança do CRV/CRLV para transferência.
Resumo
| Item | Valor |
|---|---|
| Identificador técnico | codigo-seguranca |
| Dados exigidos | placa, renavam (no catálogo: placa, renavam) |
| O que devolve | PDF com o código (sem JSON) |
| Preço vigente | R$ 19,99. Com a sua chave, GET /v1/servicos traz o seu preço. |
| Prazo | Prazo sujeito à disponibilidade da base, UF e situação do veículo. |
| Bloco veiculo | Não |
Requisição
Pelo endpoint comum de consultas, POST /v1/consultas. Os valores do exemplo são fictícios.
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-codigo-seguranca" \
-d '{"servico":"codigo-seguranca","placa":"ABC1D23","renavam":"00987495364"}'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 | Sem dados: o resultado é o documento em pdf_url. |
| erro | Valor estornado. erro_codigo diz o motivo e retryable se vale criar uma consulta nova. |
{
"id": "6f1c2e2a-1b3d-4a9e-8f7c-2a1b3c4d5e6f",
"servico": "codigo-seguranca",
"placa": "ABC1D23",
"status": "concluido",
"schema_version": "1.0",
"valor_cobrado": 19.99,
"criado_em": "2026-10-18T09:14:02-03:00",
"pdf_url": "/v1/consultas/6f1c2e2a-1b3d-4a9e-8f7c-2a1b3c4d5e6f/pdf"
}Particularidades
- placa e renavam são obrigatórios. RENAVAM com menos de 9 dígitos responde 400 RENAVAM_INVALIDO antes de cobrar.
No sandbox
Valida o formato da placa e a uf como a produção e conclui a consulta, mas não gera documento: GET /pdf responde 422 SANDBOX_SEM_DOCUMENTO. Os campos que cada UF exige (CPF, RENAVAM) só são conferidos em produção.
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.