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)

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

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)

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)

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)

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)

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

GET /blocos
GET /blocos/{id}

Parliamentary Fronts (Frentes)

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

Working Groups (Grupos de Trabalho)

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

Legislative Sessions (Legislaturas)

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

Reference Data

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

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

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

Find a deputy

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

Recent plenary votes

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

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:

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