Tudo o que um extrato afirma vem de uma destas fontes oficiais — e cada uma tem cobertura, cadência e limitações próprias. Conhecê-las é parte do método: um dado correto lido sem contexto vira conclusão errada.

## Câmara dos Deputados — API de Dados Abertos

**Endereço:** [dadosabertos.camara.leg.br](https://dadosabertos.camara.leg.br/swagger/api.html) · REST, JSON, sem autenticação.

**O que cobre:** identificação e situação de deputados federais; despesas da CEAP com **nota fiscal em PDF** (`urlDocumento`); proposições e tramitações; votações nominais com voto individual e orientação de bancada; participação em eventos; comissões e cargos.

**Cadência:** dados de despesas e votações são publicados com defasagem de dias; a situação cadastral (licença, vacância) é atualizada continuamente.

**Limitações conhecidas:**

- A **busca por nome é literal** — não tolera variação de acento ou grafia, e opera sobre o nome parlamentar (de urna), não o nome civil.
- O endpoint de eventos mostra **participação registrada, não a frequência oficial** — o registro oficial de presença em plenário é publicado separadamente em camara.leg.br.
- A busca padrão retorna só quem está **em exercício**: parlamentares licenciados ou afastados exigem consulta por legislatura.
- A **causa** de um afastamento não consta na API — exige fonte adicional (Diário da Câmara).

## Senado Federal — Dados Abertos + Portal de Transparência

**Endereço:** [legis.senado.leg.br/dadosabertos](https://legis.senado.leg.br/dadosabertos/) (JSON via header `Accept`) · despesas via CSV anual/diário no Portal de Transparência.

**O que cobre:** lista e detalhe dos 81 senadores em exercício; mandatos, titularidade e suplência; autorias com indicação de autor principal; votações; despesas da CEAPS.

**Cadência:** o CSV da CEAPS é atualizado diariamente; dados legislativos, continuamente.

**Limitações conhecidas:**

- O CSV da CEAPS exige **tratamento obrigatório**: encoding não-UTF-8 e campos vazios — sem esse tratamento, os totais saem errados (o Playbook 02 detalha; duplicatas são checagem preventiva — zero encontradas na revalidação de 2026).
- **O Senado não publica presença em sessões por senador** — o extrato usa proxies (licenças e participação em votações nominais) declarando a limitação.
- O serviço de **discursos trunca silenciosamente janelas maiores que 1 ano** (HTTP 200 com dados parciais) — a consulta correta é ano a ano.
- **Votações secretas registram só "Votou"**, sem direção — "não pública por regimento".
- A API do Senado usa estrutura XML-primeiro convertida; alguns campos mudam de forma entre endpoints.
- Autoria coletiva pode inflar contagens se o filtro de **autor principal** não for aplicado.

## CLDF — Dados Abertos (CKAN) + PLe

**Endereço:** [dados.cl.df.gov.br](https://dados.cl.df.gov.br/) (CKAN com datastore consultável por API JSON) · [ple.cl.df.gov.br](https://ple.cl.df.gov.br/) (proposições).

**O que cobre:** relação nominal mensal de deputados distritais, verba indenizatória (por comprovante, com prestador e CNPJ), remuneração mensal, diárias, proposições (via PLe) e a página oficial de normas aprovadas por parlamentar.

**Cadência:** relação nominal e remuneração são mensais; verba indenizatória, ~mensal com defasagem de semanas.

**Limitações conhecidas (validadas ao vivo em 07/2026):**

- O dataset de verbas indenizatórias é **parcial na origem** — os arquivos publicados cobrem fração dos 24 gabinetes (5 em 2025; 10 em 2026 até maio). A prestação de contas integral está no Portal da Transparência da CLDF, não no dado aberto. O extrato reporta a cobertura junto com qualquer valor.
- A busca do datastore é **sensível a acentos**, e o campo de nome mistura nome civil e nome parlamentar no mesmo recurso.
- **Votações nominais e frequência não existem em dado aberto estruturado** — só nas atas/Diário da CLDF (PDF). O extrato declara essa lacuna.
- O dataset de emendas parlamentares não tem campo de autor — atribuição por parlamentar não é possível pelo dado aberto.

## O que este site deliberadamente NÃO usa

- **Fontes secundárias** (imprensa, agregadores, wikis): violam a regra da fonte primária — qualquer afirmação sem URL oficial não entra no extrato.
- **Bancos de dados próprios:** os dados ficam onde sempre estiveram, nos servidores públicos. A consulta acontece no momento do uso, pela IA do próprio cidadão.
- **Dados eleitorais** (TSE, candidaturas, campanhas): fora de escopo por desenho — este projeto cobre apenas mandatos em exercício.

## Validação

Os endpoints documentados nos playbooks são validados ao vivo toda semana pelo CI do mantenedor. O resultado é um snapshot promovido por merge humano: a data e o estado por fonte aparecem no selo da [página inicial](/), e a tabela completa — endpoint por endpoint, com status HTTP, formato e latência, só metadados — está em [saúde das fontes](/saude-das-fontes) (dado bruto em [/endpoints-health.json](/endpoints-health.json)). Mudanças de método entram no [changelog](/changelog). Encontrou um endpoint fora do ar ou com formato alterado? Reporte: [segurança](/seguranca).