API de consultaSob demanda

API Light 2ª via: a conta de luz pelo CNPJ e CEP

Envie o CNPJ do titular e o CEP da instalação; pelo Acesso rápido da Agência Virtual da Light, sem login, voltam as contas não pagas em PDF, com o código de barras.

Baixar contas da Light pela API Ver todas as consultas

Acesso no mesmo dia, com crédito para testar · atualizado em 27 de outubro de 2026

1
Entrada
cnpjcepinstalacao
2
Fonte oficial
LightAgência Virtual, Acesso rápido Segunda Via de Conta
3
Saída
JSON e PDF da conta
CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Instalação, valores e código de barras fictícios.

Parâmetros

cnpjobrigatório
O CNPJ titular da conta. É o único campo obrigatório da tela.
cepopcional
O CEP da instalação, para separar as contas quando o CNPJ tem mais de um endereço.
instalacaoopcional
Para ficar com uma unidade só, quando a lista traz várias.

status: concluida quando o órgão respondeu; em_andamento enquanto a fonte não libera (o resultado chega por webhook); fonte_indisponivel quando o portal está fora do ar, que nunca vira "nada consta".
resultado.contas[].instalacao: A unidade consumidora da conta.
resultado.contas[].codigo_barras: A numeração para pagar pelo aplicativo do banco ou internet banking.
resultado.situacao: negativa, positiva, positiva_com_efeito_de_negativa ou nao_emitida: o mesmo vocabulário em todas as fontes.
resultado.numero_certidao: O número ou código de controle impresso no documento, para validar no próprio órgão.
resultado.emissao: Data e hora da emissão, como o documento registra.
resultado.valida_ate: A validade lida no documento; null quando o órgão não fixa prazo.
resultado.texto_completo: O texto integral do documento, extraído do PDF, para guardar e pesquisar sem abrir o arquivo.
pdf_url: A conta como a Light emite no download da 2ª via.

Tela do Acesso rápido Segunda Via de Conta da Light: campos de CNPJ e CEP e botão Prosseguir — Sem login e sem taxa: só contas não pagas.
Fontes oficiais
Light: Acesso rápido Segunda Via de Conta (Agência Virtual)
Light: Segunda via de conta, informações sobre o serviço
Light: Comprovante de conta paga

RespostaJSON

{"protocolo": "a1b2c3d4","status": "concluida","consulta": "light_segunda_via","orgao": "Light","cnpj": "00000000000100","cep": "20000000","resultado": {"situacao": "negativa","numero_certidao": "000000/2026","emissao": "2026-10-27T10:15:00-03:00","valida_ate": "2026-11-26","contas": [{"instalacao": "0000000000","mes_referencia": "2026-10","vencimento": "2026-11-12","valor": 0,"codigo_barras": "00000000000 0 00000000000 0 00000000000 0 00000000000 0"}],"texto_completo": "Texto integral do documento, lido do PDF emitido pelo órgão (exemplo)."},"pdf_url": "https://…/conta.pdf"}

Como o resultado chega

A mesma estrutura em qualquer órgão: um status classificado e, quando a fonte emite, o PDF oficial. Só a consulta concluída é cobrada; tentativa sem resultado não entra na conta.

Regular
verde
Nada consta na fonte.
Atenção
amarelo
Há registro que não impede, como débito parcelado ou suspenso. Vale ler o documento.
Com apontamentos
vermelho
Consta débito, sanção ou processo. O documento vem junto.
Sem resposta
cinza
A fonte não respondeu, o captcha falhou ou ficou fora deste ciclo. Vira reprocessamento, nunca um "nada consta" falso.

A entrega sai em JSON, CSV, XLSX ou XML, por API REST, webhook ou direto no seu ERP. Portal que muda de layout, adiciona captcha ou troca de sistema é conta nossa: você paga pela entrega, não pelo conserto.

Ficha técnica

Contas	Só as não pagas; para as pagas, existe o comprovante de conta paga
Fatura individual	PDF da conta ou código de barras único para várias contas
Fatura agrupada	Demonstrativo por instalação e capa da fatura
Download	A tela pede o motivo da solicitação antes de baixar
Taxa	Nenhuma: a Light não cobra pela 2ª via

Perguntas frequentes

Precisa de login na Agência Virtual?

Não. O Acesso rápido pede o CNPJ e o CEP; o login só é necessário para outros serviços.

Dá para baixar uma conta que já foi paga?

Pela 2ª via, não: ela traz só contas não pagas. A conta paga sai no serviço Comprovante de conta paga.

Empresa com fatura agrupada também consegue?

Sim. O serviço emite o demonstrativo por instalação, a capa da fatura e o código de barras da fatura agrupada.

API Light 2ª via de conta na sua integração

Sob demanda. Acesso no mesmo dia, com crédito para testar.

Baixar contas da Light pela API

A coleta é feita em fonte pública oficial: a Hath Data não é a fonte e não certifica o conteúdo publicado pelo órgão. O serviço é prestado sob contrato, o cliente é o controlador dos dados e declara a finalidade; a Hath atua como operadora. Nomes de órgãos são citados apenas para identificar a fonte, sem vínculo ou endosso. Veja os termos de uso e a política de privacidade.