Consultando uma emissão

Pelo job_id

curl -s https://api.conota.dev/v1/nfe/consultar/$JOB_ID \
  -H "X-API-Key: $CONOTA_API_KEY"

A resposta traz os dois eixos de estado — o do processamento e o fiscal. Ver Status das emissões.

Em lote

Até 200 ids por chamada, resolvidos em poucas queries:

POST /v1/jobs/consultar-lote

{ "job_ids": ["6f8dc295-...", "8881bac5-..."] }

Id inexistente ou de outra conta volta como "status": "nao_encontrado" — sem 404, e sem vazar a existência de dados de terceiros.

Quando o job_id se perdeu

GET /v1/jobs/localizar?ref=pedido_98231

Ou por atributos de negócio — emitente, destinatário, valor exato, período:

GET /v1/jobs/localizar?cpf_cnpj=60772432000142&valor=1500.00&de=2026-09-01&ate=2026-09-03

Zero resultado é informação

Nenhum resultado é forte indício de que a emissão nunca aconteceu. É essa a pergunta que você precisa responder antes de reenviar depois de um timeout.

Pela chave de acesso

GET /v1/notas/{chave}

Investigando uma rejeição

GET /v1/jobs/{job_id}/itens

Devolve os itens com os grupos tributários (ICMS, PIS/COFINS, IBS/CBS) e marca qual item provocou a rejeição — em vez de deixar você conferir item por item.