Câmara dos Deputados

Access and search Brazilian Chamber of Deputies data including deputies, bills, votes, committees, agendas, expenses, and legislative statuses via public API...

Daniel Marques@olegantonov

Install

openclaw skills install @olegantonov/camara-deputados

Câmara dos Deputados — API de Dados Abertos

Base URL: https://dadosabertos.camara.leg.br/api/v2 Docs/Swagger: https://dadosabertos.camara.leg.br/swagger/api.html No authentication required. All endpoints return JSON.

Common query params

itens — page size (default 15, max 100)
pagina — page number
ordem — ASC or DESC
ordenarPor — field name for sorting

Key Endpoints

Deputies (Deputados)

text

GET /deputados
  ?nome=         # name search
  ?siglaPartido= # party (e.g. PT, PL, MDB)
  ?siglaUf=      # state (e.g. SP, RJ, AM)
  ?idLegislatura=57  # current legislature
  ?ordem=ASC&ordenarPor=nome

GET /deputados/{id}           # full profile
GET /deputados/{id}/discursos # speeches
  ?dataInicio=YYYY-MM-DD&dataFim=YYYY-MM-DD
GET /deputados/{id}/despesas  # CEAP expenses
  ?ano=YYYY&mes=MM
GET /deputados/{id}/frentes   # parliamentary fronts
GET /deputados/{id}/ocupacoes # professional history
GET /deputados/{id}/orgaos    # committee memberships

Bills / Proposições

text

GET /proposicoes
  ?siglaTipo=PL      # type: PL, PEC, MPV, PDC, PLP, etc.
  ?numero=123
  ?ano=2026
  ?autor=Nome        # author name (partial match)
  ?tema=             # topic id (see /referencias/temas)
  ?keywords=         # keywords
  ?dataApresentacaoInicio=YYYY-MM-DD
  ?dataApresentacaoFim=YYYY-MM-DD
  ?codSituacao=      # status code
  ?tramitacaoSenado=true  # bills currently in Senate
  ?ordem=DESC&ordenarPor=id

GET /proposicoes/{id}             # full detail
GET /proposicoes/{id}/autores     # authorship
GET /proposicoes/{id}/relacionadas# related bills
GET /proposicoes/{id}/temas       # topics
GET /proposicoes/{id}/tramitacoes # full history/status
GET /proposicoes/{id}/votacoes    # votes on this bill

Votações (Voting)

text

GET /votacoes
  ?dataInicio=YYYY-MM-DD&dataFim=YYYY-MM-DD
  ?idOrgao=180       # 180 = Plenário
  ?siglaPartido=
  ?ordem=DESC&ordenarPor=dataHoraRegistro

GET /votacoes/{id}             # vote detail
GET /votacoes/{id}/votos       # individual votes per deputy
GET /votacoes/{id}/orientacoes # party orientations

Events / Agenda (Eventos)

text

GET /eventos
  ?dataInicio=YYYY-MM-DD
  ?dataFim=YYYY-MM-DD
  ?siglaOrgao=       # committee sigla or PLEN for plenary
  ?codTipoEvento=    # see /referencias/tiposEvento
  ?codSituacao=      # see /referencias/situacoesEvento
  ?ordem=ASC&ordenarPor=dataHoraInicio

GET /eventos/{id}          # event detail
GET /eventos/{id}/deputados # attending deputies
GET /eventos/{id}/orgaos    # organizing bodies
GET /eventos/{id}/pauta     # agenda items
GET /eventos/{id}/votacoes  # votes in this session

Committees (Órgãos / Comissões)

text

GET /orgaos
  ?sigla=CCJC        # committee abbreviation
  ?codTipoOrgao=     # type (see /referencias/tiposOrgao)
  ?nome=

GET /orgaos/{id}            # detail
GET /orgaos/{id}/eventos    # committee agenda
GET /orgaos/{id}/membros    # current membership
GET /orgaos/{id}/votacoes   # votes by committee

Parties & Blocs (Partidos / Blocos)

text

GET /partidos?ordem=ASC&ordenarPor=sigla
GET /partidos/{id}
GET /partidos/{id}/membros

GET /blocos
GET /blocos/{id}

Parliamentary Fronts (Frentes)

text

GET /frentes
GET /frentes/{id}
GET /frentes/{id}/membros

Working Groups (Grupos de Trabalho)

text

GET /gruposTrabalho
GET /gruposTrabalho/{id}
GET /gruposTrabalho/{id}/membros

Legislative Sessions (Legislaturas)

text

GET /legislaturas
GET /legislaturas/{id}
GET /legislaturas/{id}/mesa  # presiding board

Reference Data

text

GET /referencias/deputados/codSituacao
GET /referencias/proposicoes/codSituacaoProposicao
GET /referencias/proposicoes/siglaTipo
GET /referencias/proposicoes/tema
GET /referencias/tiposEvento
GET /referencias/tiposOrgao
GET /referencias/uf

Common Tasks

Today's agenda

bash

DATE=$(date +%Y-%m-%d)
curl "https://dadosabertos.camara.leg.br/api/v2/eventos?dataInicio=$DATE&dataFim=$DATE&ordem=ASC&ordenarPor=dataHoraInicio"

Search bills by keyword

bash

curl "https://dadosabertos.camara.leg.br/api/v2/proposicoes?keywords=transporte+público&ano=2026&ordem=DESC&ordenarPor=id&itens=20"

Find a deputy

bash

curl "https://dadosabertos.camara.leg.br/api/v2/deputados?nome=Marcos+Pontes&idLegislatura=57"

Recent plenary votes

bash

curl "https://dadosabertos.camara.leg.br/api/v2/votacoes?idOrgao=180&dataInicio=2026-03-01&ordem=DESC&ordenarPor=dataHoraRegistro&itens=10"

Bill status / tramitação

bash

curl "https://dadosabertos.camara.leg.br/api/v2/proposicoes/{id}/tramitacoes"

Notes

Legislature 57 = current (started Feb 2023)
Plenário orgão id = 180
CEAP data also available as bulk download: https://www.camara.leg.br/cotas/Ano-{ano}.json.zip
Full API reference: see references/api-endpoints.md for parameter details
Swagger UI: https://dadosabertos.camara.leg.br/swagger/api.html

API Quirks & Tips

Standard response wrapper: All endpoints return {dados: [...], links: [...]}. The Python client's _get() automatically extracts dados.
Pagination: Use itens (page size, max 100) and pagina (page number). The Python client's _get_list() auto-paginates — if dados has fewer items than itens, it's the last page.
Date format: Always ISO format YYYY-MM-DD (unlike Senado which uses YYYYMMDD).
Legislature 57: Current legislature (2023-2027). Most endpoints default to current if not specified.
Plenário ID: orgão id = 180 for plenary hall.
tramitacaoSenado: Use ?tramitacaoSenado=true on proposições endpoint to find bills currently being reviewed by the Senate.
CEAP bulk data: Deputy expenses also available as bulk download at https://www.camara.leg.br/cotas/Ano-{ano}.json.zip.

Python Client (async)

You can use the async Python client for programmatic access:

python

import asyncio
from camara_client import get_camara_client

async def main():
    client = get_camara_client()
    
    # Listar deputados
    deps = await client.lista_deputados()
    
    # Buscar por nome
    resultado = await client.buscar_deputado_por_nome("Lula")
    
    # Pesquisar proposições
    props = await client.pesquisar_proposicoes(keywords="transporte", ano=2026)
    
    # Eventos de hoje
    from datetime import date
    eventos = await client.get_eventos_dia(date.today())
    
    await client.close()

asyncio.run(main())

Available Methods

Deputados:

lista_deputados(legislatura) — List deputies
buscar_deputado_por_nome(nome, legislatura) — Search by name
get_deputado_detalhe(id) — Full profile
get_despesas_deputado(id, ano) — CEAP expenses
get_frentes_deputado(id) — Parliamentary fronts
get_discursos_deputado(id, data_inicio, data_fim) — Speeches
get_presenca_deputado(id, data_inicio, data_fim) — Attendance
get_deputado_orgaos(id) — Committee memberships
get_deputado_ocupacoes(id) — Professional history

Proposições:

pesquisar_proposicoes(keywords, sigla_tipo, numero, ano, autor, tramitando, tema, tramitacao_senado) — Search bills
get_proposicao_detalhe(id) — Full detail
get_proposicao_tramitacao(id) — Status history
get_proposicao_votacoes(id) — Votes on bill
get_proposicao_autores(id) — Authors
get_proposicao_temas(id) — Topics/tags
get_proposicao_relacionadas(id) — Related bills

Eventos:

get_eventos_dia(data) — Day agenda
get_eventos_periodo(data_inicio, data_fim) — Events in period
get_evento_detalhe(id) — Event detail
get_evento_deputados(id) — Deputies in event
get_evento_orgaos(id) — Organizing bodies
get_evento_votacoes(id) — Votes in event

Votações:

get_votacoes_periodo(data_inicio, data_fim, id_orgao) — Votes in period
get_votacao_detalhe(id) — Vote detail
get_votos_votacao(id) — Individual votes
get_orientacoes_votacao(id) — Party orientations

Órgãos/Comissões:

lista_orgaos() — List committees
get_orgao_detalhe(id) — Committee detail
get_eventos_orgao_periodo(id, data_inicio, data_fim) — Committee agenda
get_membros_orgao(id) — Current members
get_orgao_membros_periodo(id, data_inicio, data_fim) — Members in period
get_votacoes_orgao(id, data_inicio, data_fim) — Committee votes

Legislaturas:

lista_legislaturas() — List legislatures
get_legislatura_detalhe(id) — Legislature detail
get_legislatura_mesa(id) — Presiding board

Partidos:

lista_partidos() — List parties
get_partido_detalhe(id) — Party detail
get_partido_membros(id) — Party members

Blocos:

lista_blocos() — List parliamentary blocs
get_bloco_detalhe(id) — Bloc detail

Frentes:

lista_frentes(id_legislatura) — List parliamentary fronts
get_frente_detalhe(id) — Front detail
get_frente_membros(id) — Front members

Referências:

get_referencias_situacao_deputado() — Deputy status codes
get_referencias_situacao_proposicao() — Bill status codes
get_referencias_tipo_proposicao() — Bill type codes (PL, PEC, etc)
get_referencias_temas() — Topic/theme list
get_referencias_tipos_evento() — Event types
get_referencias_tipos_orgao() — Committee types
get_referencias_uf() — Brazilian states

Utilitários:

get_proposicoes_recentes(dias) — Recent bills
get_votacoes_semana() — This week's votes
get_eventos_semana() — This week's events
get_pauta_evento(id) — Event agenda items

Requires: pip install httpx

Câmara dos Deputados

Install

Câmara dos Deputados — API de Dados Abertos

Common query params

Key Endpoints

Deputies (Deputados)

Bills / Proposições

Votações (Voting)

Events / Agenda (Eventos)

Committees (Órgãos / Comissões)

Parties & Blocs (Partidos / Blocos)

Parliamentary Fronts (Frentes)

Working Groups (Grupos de Trabalho)

Legislative Sessions (Legislaturas)

Reference Data

Common Tasks

Today's agenda

Search bills by keyword

Find a deputy

Recent plenary votes

Bill status / tramitação

Notes

API Quirks & Tips

Python Client (async)

Available Methods

Related skills