Pular para o conteúdo
ZapCar
Developersv1

CRLV Digital

Emissão do CRLV Digital em PDF para as UFs disponíveis; algumas exigem CPF/CNPJ e/ou RENAVAM.

crlvPDFa partir de R$ 26,99

Resumo

ItemValor
Identificador técnicocrlv
Dados exigidosplaca, uf (+ cpf/renavam em algumas UFs) (no catálogo: placa, uf)
O que devolveDocumento em PDF (sem JSON)
Preço vigentea partir de R$ 26,99. Com a sua chave, GET /v1/servicos traz o seu preço.
PrazoA emissão costuma sair em poucos minutos; depende da resposta do órgão emissor do estado.
Bloco veiculoNão
ObservaçãoPreço varia por UF.

UFs, preço e campos exigidos

Do catálogo vigente. A fonte da verdade é crlv.preco_por_uf em GET /v1/servicos: leia de lá em vez de fixar no código.

UFPreçoExigeEmissão
AMR$ 31,99placa, ufdisponível
APR$ 29,99placa, ufdisponível
BAR$ 29,99placa, uf, cpf, renavamdisponível
CER$ 44,99placa, ufdisponível
GOR$ 29,99placa, ufdisponível
MAR$ 29,99placa, ufdisponível
MGR$ 29,99placa, uf, cpfdisponível
MSR$ 29,99placa, ufdisponível
MTR$ 27,99placa, uf, cpf, renavamdisponível
PAR$ 30,00placa, uf, cpf, renavamdisponível
PER$ 45,00placa, uf, cpf, renavamdisponível
PIR$ 26,99placa, uf, renavamdisponível
PRR$ 33,99placa, uf, renavamdisponível
RJR$ 36,99placa, ufdisponível
RNR$ 34,99placa, ufdisponível
SER$ 33,99placa, ufdisponível
SPR$ 29,99placa, uf, cpf, renavamdisponível
TOR$ 31,99placa, uf, cpf, renavamdisponível
ACR$ 80,00placa, ufindisponível no momento
ALR$ 42,99placa, ufindisponível no momento
DFR$ 70,00placa, ufindisponível no momento
ESR$ 50,00placa, ufindisponível no momento
PBR$ 65,00placa, ufindisponível no momento
ROR$ 55,00placa, ufindisponível no momento
RRR$ 55,00placa, ufindisponível no momento
RSR$ 100,00placa, ufindisponível no momento
SCR$ 70,00placa, ufindisponível no momento

Requisição

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

cURLPOST /v1/consultas (crlv)
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-crlv" \
  -d '{"servico":"crlv","placa":"ABC1D23","uf":"SP","cpf":"12345678909","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:

statusO que vem
processandoSó o envelope. Consulte de novo em 3 a 5 s.
concluidoSem dados: o resultado é o documento em pdf_url.
erroValor estornado. erro_codigo diz o motivo e retryable se vale criar uma consulta nova.
JSONresposta 200: concluído (só documento, sem dados)
{
  "id": "6f1c2e2a-1b3d-4a9e-8f7c-2a1b3c4d5e6f",
  "servico": "crlv",
  "placa": "ABC1D23",
  "uf": "SP",
  "status": "concluido",
  "schema_version": "1.0",
  "valor_cobrado": 26.99,
  "criado_em": "2026-10-18T09:14:02-03:00",
  "pdf_url": "/v1/consultas/6f1c2e2a-1b3d-4a9e-8f7c-2a1b3c4d5e6f/pdf"
}

Particularidades

  • Preço e campos exigidos variam por UF: leia crlv.preco_por_uf em GET /v1/servicos, que traz o requer de cada estado. UF fora da lista responde 422 SERVICO_INDISPONIVEL; faltando CPF/RENAVAM que a UF exige, 400 CRLV_DADOS_OBRIGATORIOS.
  • Em CE, DF, ES, PB, RJ, RN, RS e SC a emissão é processada pelo DETRAN de forma assíncrona e pode levar alguns minutos em processando. Não trate como erro: prefira o webhook query.completed.
  • O documento pode chegar como PDF ou imagem: confie no Content-Type do GET /pdf.

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.