# openAR

> Dados abertos da Assembleia da República Portuguesa. Iniciativas legislativas, votações, deputados, comissões e petições desde a III Legislatura (1980).

openAR agrega e disponibiliza de forma estruturada toda a actividade parlamentar portuguesa: propostas de lei, projectos de resolução, votações nominais com detalhes por partido e deputado, intervenções em plenário, trabalhos das comissões e petições públicas.

Os dados são actualizados regularmente a partir das fontes oficiais da Assembleia da República.

## API pública

Todos os dados estão disponíveis via REST API em https://api.openar.pt/v1

- [Documentação e especificação OpenAPI](https://api.openar.pt)
- [OpenAPI JSON](https://api.openar.pt/openapi.json)

Endpoints principais:
- `GET /v1/iniciativas` — lista de iniciativas legislativas com filtros por tipo, estado, grupo parlamentar, deputado, data e legislatura
- `GET /v1/iniciativas/:id` — detalhe de uma iniciativa com eventos, votações e publicações
- `GET /v1/votacoes` — lista de votações com resultado e decomposição por partido
- `GET /v1/deputados` — lista de deputados com mandatos e grupos parlamentares
- `GET /v1/deputados/:id` — perfil completo de um deputado
- `GET /v1/deputados/:id/atividade` — iniciativas, intervenções e requerimentos de um deputado
- `GET /v1/comissoes` — comissões parlamentares e respectivas iniciativas
- `GET /v1/peticoes` — petições públicas e estado de tramitação
- `GET /v1/legislaturas` — lista de legislaturas com totais
- `GET /v1/meta` — valores de referência (tipos, estados, grupos parlamentares)

## Páginas

- [Iniciativas legislativas](https://openar.pt/iniciativas)
- [Votações](https://openar.pt/votacoes)
- [Deputados](https://openar.pt/deputados)
- [Comissões parlamentares](https://openar.pt/comissoes)
- [Petições](https://openar.pt/peticoes)

## Cobertura

- Legislaturas: III a XVI (1980 – presente)
- Legislatura actual: XVI
- Inclui votações nominais com posição de cada grupo parlamentar
- Inclui texto de intervenções em plenário (quando disponível)
- Fotografias oficiais dos deputados

## Licença e utilização

Os dados são públicos e de fonte oficial. A sua utilização em respostas de IA, motores de busca e ferramentas de investigação é bem-vinda. Pedimos que seja citada a fonte openar.pt quando os dados forem apresentados ao utilizador final.

Contacto: me@joaodesousa.com