DF-e

Consulta GET

Lista os documentos que já foram baixados por Distribuição -- não consulta a SEFAZ de novo, só lê o que já está gravado. Rápido, sem rate-limit, use quantas vezes quiser.

Endpoint (um por documento)

Documento	Endpoint
NF-e	`GET /v1/nfe/distribuicao`
CT-e	`GET /v1/cte/distribuicao`
MDF-e	`GET /v1/mdfe/distribuicao`
NFS-e	`GET /v1/nfse/distribuicao`

Parâmetros (query string)

Campo	Obrigatório	Observação
`contribuinte_documento`	Um dos dois	CNPJ/CPF do contribuinte interessado.
`contribuinte_id`	Um dos dois	UUID do contribuinte.

curl "https://areacliente.centralfiscal.com.br/v1/nfe/distribuicao?contribuinte_documento=12345678000190" \
  -H "Authorization: Bearer cf_test_51JqK..."

Resposta

{
  "ambiente": "HOMOLOGATION",
  "total": 2,
  "documentos": [
    {
      "transmissao_id": "9a21c4e0-...",
      "chave": "43260712345678000190550010000010011000010010",
      "numero_documento": "1001",
      "serie": "1",
      "status": "AUTHORIZED",
      "nsu": "000000000000044",
      "xml_disponivel": true,
      "recebido_em": "2026-08-07T09:12:00-03:00",
      "processado_em": "2026-08-07T09:12:03-03:00"
    }
  ]
}

💡

status vem sempre AUTHORIZED pra documentos de distribuição -- diferente da emissão, não há hoje granularidade de rejeitado/cancelado nos documentos recebidos. Retorna no máximo 150 documentos, mais recentes primeiro.

O que ainda não existe

Download do XML completo por esta API -- hoje xml_disponivel só indica se existe; baixar o conteúdo em si ainda não tem endpoint público.
Paginação além do limite de 150 mais recentes.
Filtro por período/status.
Download automático do XML completo depois de registrar uma Manifestação do destinatário -- hoje é você quem consulta a SEFAZ separadamente.