Documentos
Leitura de CRLV
AtivaOCRRequisição e token● tempo real
POST
/api/v1/oracle/document/crlvConfere se o arquivo é um CRLV (Certificado de Registro e Licenciamento de Veículo), no formato digital ou impresso, e devolve RENAVAM, placa, chassi, exercício, anos de fabricação e modelo, marca, modelo, cor, combustível e o nome e CPF/CNPJ do proprietário.
Envie a imagem ou o PDF em file. conferencias diz se placa, RENAVAM, chassi e CPF/CNPJ fecham no formato e nos dígitos verificadores: false indica leitura ruim ou documento adulterado, e null, campo que não veio.
É leitura do documento enviado: não consulta a base do Detran nem a situação do veículo.
Tecnologia: OCR com visão computacional · tempo real
Campos da resposta
Dados que esta API devolve em cada chamada.
Na página
Tipo de documento
document_typeArquivo enviadofilenameParecer e dados do CRLVvalidation_resultDocumento reconhecidois_validTipo de documentotipo_documentoRENAVAMrenavamPlacaplacaPlaca anterior / UFplaca_anterior_ufExercícioexercicioAno de fabricaçãoano_fabricacaoAno-modeloano_modeloNº do CRVnumero_crvCasos de uso
Onde esta API entra no seu processo.
Preencher placa, chassi e ano do veículo a partir do CRLV enviado pelo cliente.
Testar e integrar
Execute uma chamada e copie o código para a sua aplicação.
POST
https://api.apifordevs.com/api/v1/oracle/document/crlvChave de API necessária · multipart/form-data · 30 req./min · Cobrança apenas em respostas 2xx
Autenticação
AuthorizationheaderInjetado automaticamenteChave de API em Basic: public_key:secret_key em Base64.
Sessão do painel · ••••••••
X-Project-IdheaderInjetado automaticamenteProjeto que recebe a chamada. Sem ele, vale o projeto padrão da conta.
Projeto selecionado no painel
Idempotency-KeyheaderOpcionalRepetir a mesma chave em até 24 horas devolve a resposta anterior, sem executar nem cobrar de novo.
Parâmetros
filefileObrigatório
Imagem, HEIC ou PDF do CRLV.
A simulação devolve um exemplo sem chamar o serviço nem cobrar. A execução pede confirmação antes da cobrança.
Execute a requisição para ver a resposta aqui.
Exemplos de requisição
curl -X POST 'https://api.apifordevs.com/api/v1/oracle/document/crlv?summary=true' \ -u "afd_live_pk_...:$APIFORDEVS_LIVE_SECRET" \ -H 'X-Project-Id: proj_...' \ -F 'file=@./YOUR_FILE'Exemplo de resposta
DocumentValidateOutput{ "success": true, "code": 200, "code_message": "A requisição foi processada com sucesso.", "errors": [], "header": null, "data_count": 1, "data": [ { "document_type": "CRLV", "filename": "crlv-e.pdf", "validation_result": { "is_valid": true, "tipo_documento": "CRLV-e", "renavam": "01234567897", "placa": "ABC1D23", "placa_anterior_uf": "ABC1234/SP", "exercicio": "2026", "ano_fabricacao": "2019", "ano_modelo": "2020", "numero_crv": "012345678901", "codigo_seguranca_cla": "01234567890", "marca_modelo_versao": "FIAT/ARGO DRIVE 1.0", "especie_tipo": "PASSAGEIRO AUTOMOVEL", "chassi": "9BD358A1NLY123456", "cor_predominante": "PRATA", "combustivel": "ALCOOL/GASOLINA", "categoria": "PARTICULAR", "capacidade": "", "potencia_cilindrada": "77CV/999", "peso_bruto_total": "1.5", "motor": "", "cmt": "1.6", "eixos": "", "lotacao": "05P", "carroceria": "NAO APLICAVEL", "nome_proprietario": "FULANO DE TAL DA SILVA", "cpf_cnpj_proprietario": "529.982.247-25", "local_emissao": "SAO PAULO SP", "data_emissao": "05/01/2026", "observacoes": "SEM OBSERVACOES", "descricao": "CRLV-e do exercício 2026, legível", "conferencias": { "placa": true, "renavam": true, "chassi": true, "cpf_cnpj": true } } } ]}Códigos de resposta
| Status | errors[].code | Quando acontece | Cobrança |
|---|---|---|---|
| 200 | — | Sucesso. | Sim |
| 400 | bad_request, live_key_cannot_use_dev_mode | Arquivo ou parâmetro que a rota não consegue processar, projeto inválido, ou `dev_mode=true` com chave de produção. | Não |
| 401 | unauthorized | Credencial ausente, inválida ou revogada. | Não |
| 402 | payment_required | Saldo insuficiente ou limite de gasto diário atingido. | Não |
| 403 | forbidden, ip_not_allowed, test_key_cannot_run_live | E-mail da conta não verificado, chave sem escopo para o serviço, IP fora da allowlist do projeto ou chave de teste sem `dev_mode=true`. | Não |
| 409 | conflict | Requisição com a mesma `Idempotency-Key` ainda em andamento. | Não |
| 413 | payload_too_large | Arquivo acima de 20 MB. | Não |
| 422 | validation_error | Parâmetro obrigatório ausente ou fora do formato, ou `Idempotency-Key` repetida com outro conteúdo. | Não |
| 429 | rate_limit_exceeded | Limite de requisições por minuto da chave atingido. | Não |
| 500 | internal_error | Falha interna. | Não |
| 503 | service_unavailable | Serviço desativado ou temporariamente indisponível. | Não |
Preço por consultaR$ 0,1037