Gastos dos Senadores - API
A API de Gastos dos Senadores é uma API que disponibiliza dados reais sobre os gastos dos senadores brasileiros. Ela pode ser utilizada para fins de pesquisa, jornalismo, desenvolvimento de projetos e outras iniciativas que visem a transparência e o controle público dos recursos públicos.
Trata-se de uma série de endpoints que fornecem informações detalhadas sobre os gastos realizados por cada senador, incluindo informações sobre o partido, o valor, a data, a descrição e o tipo de gasto.
A API de Gastos dos Senadores é uma API pública e gratuita. Ela é atualizada periodicamente com os dados mais recentes disponíveis no Portal da Transparência do Senado Federal.
Contexto - Cotas para Exercício da Atividade Parlamentar (CEAP)
Os gastos dos senadores são uma parte importante da transparência e da prestação de contas no Brasil. Aqui, nesta API estamos considerando exclusivamente os chamados "gastos de gabinete", que são os recursos disponíveis para os senadores para o exercício de suas atividades parlamentares - tais como aluguel de imóveis, passagens aéreas, combustíveis, alimentação, hospedagem, entre outros.
Em termos técnicos, os gastos de gabinete são chamados de "Cota para o Exercício da Atividade Parlamentar" (CEAP) e são regulamentados pela Resolução do Senado Federal nº 23/2007. Essa cota é destinada ao custeio exclusivo de despesas vinculadas ao exercício da atividade parlamentar não podendo ser utilizadas para outros fins.
Mais informações estão disponíveis nesse link
Frequência de Atualização
Os dados da API são atualizados diariamente com base nas informações disponíveis no Portal da Transparência do Senado Federal.
Se você encontrar quaisquer inconsistências ou erros nos dados, por favor, entre em contato conosco para que possamos corrigi-los o mais rápido possível 🚀
Autenticação
A API de Gastos dos Senadores não requer autenticação para acessar os endpoints.
Rate Limit
A API de Gastos dos Senadores possui um limite de taxa de 100 solicitações por minuto. Se você exceder esse limite, receberá um código de status 429. O uso indiscriminado também poderá levar ao bloqueio do seu IP.
Base URL
A URL base para a API de gastos dos senadores do Codante.io é https://apis.codante.io/senator-expenses
.
Lista de Senadores
Este endpoint lista todos os senadores com informações básicas, como nome completo, partido, estado e outros detalhes relevantes. Esse endpoint é paginado e traz 100 senadores por página.
Atributos opcionais
- Name
active
- Type
- string
- Description
Filtra apenas os parlamentares que estão com mandato ativo atualmente.
- Name
uf
- Type
- string
- Description
Filtra por estado (ex: "SP", "RJ").
- Name
party
- Type
- string
- Description
Filtra por partido. Para uma lista completa, vide endpoint
parties
.
Request
curl -G https://apis.codante.io/senator-expenses/senators
Response
{
"data": [
{
"id": 42068,
"name": "Leila Barros",
"full_name": "Leila Gomes de Barros Rêgo",
"gender": "Feminino",
"UF": "DF",
"avatar_url": "http:\/\/www.senado.leg.br\/senadores\/img\/fotos-oficiais\/senador5979.jpg",
"homepage": "http:\/\/www25.senado.leg.br\/web\/senadores\/senador\/-\/perfil\/5979",
"email": "sen.leilabarros@senado.leg.br",
"party": "PDT",
"is_titular": 1,
"is_active": 1
},
// ...
],
"links": {
"first": "http:\/\/127.0.0.1:8000\/senator-expenses\/senators?page=1",
"last": "http:\/\/127.0.0.1:8000\/senator-expenses\/senators?page=20",
"prev": null,
"next": "http:\/\/127.0.0.1:8000\/senator-expenses\/senators?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 20,
"links": [
// ...
],
"path": "http:\/\/127.0.0.1:8000\/senator-expenses\/senators",
"per_page": 100,
"to": 100,
"total": 1943
}
]
}
Gastos de um Senador
Exibe os gastos realizados por um senador específico, com informações detalhadas sobre cada gasto, como data, valor, descrição e tipo de gasto. Esse endpoint é paginado e traz 100 gastos por página.
A chave meta
traz também o valor total dos gastos daquele senador bem como a quantidade de lançamentos (expenses_sum
, expenses_avg
e expenses_count
).
Atributos opcionais
- Name
year
- Type
- string
- Description
Filtra apenas as despesas do ano específico. Exemplo:
2023
.
Request
curl -G https://apis.codante.io/senator-expenses/senators/42068/expenses
Response
{
"data": [
{
"id": 26314,
"original_id": "2193941",
"date": "2023-01-26T00:00:00.000000Z",
"amount": "700.00",
"expense_category": "Aluguel de imóveis para escritório político, compreendendo despesas concernentes a eles.",
"description": null,
"supplier": "SEMEAR CONSULTORIA IMOBILIARIA LTDA",
"supplier_document": "12.239.769\/0001-46",
"senator": {
"id": 42068,
"name": "Leila Barros",
"party": "PDT",
"UF": "DF",
"is_active": 1
}
},
// ...
],
"links": {
// ...
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
// ...
],
"path": "http:\/\/127.0.0.1:8000\/senator-expenses\/senators\/42068\/expenses",
"per_page": 100,
"to": 92,
"total": 92,
"expenses_sum": "185180.97",
"expenses_avg": "2012.84",
"expenses_count": 92
}
}
Lista de Partidos
Lista todos os partidos políticos dos senadores. Traz apenas a sigla do partido.
Request
curl -G https://apis.codante.io/senator-expenses/parties
Response
{
"data": [
{
"id": "AVANTE"
},
{
"id": "CIDADANIA"
},
// ...
]
}
Gastos de um Partido
Lista todos os gastos realizados por senadores de um partido específico, com informações detalhadas sobre cada gasto, como data, valor, descrição, tipo de gasto e senador responsável. Esse endpoint é paginado e traz 100 gastos por página.
A chave meta
traz também o valor total dos gastos daquele partido bem como a quantidade total de lançamentos e de senadores (expenses_sum
, expenses_avg
, expenses_count
, senators_count
).
Atributos opcionais
- Name
year
- Type
- string
- Description
Filtra apenas as despesas do ano específico. Exemplo:
2023
.
Request
curl -G https://apis.codante.io/senator-expenses/parties/MDB/expenses
Response
{
"data": [
{
"id": 58414,
"original_id": "2228361",
"date": "2025-05-17T00:00:00.000000Z",
"amount": "2400.00",
"expense_category": "Locomoção, hospedagem, alimentação, combustíveis e lubrificantes",
"description": null,
"supplier": "HOTEL PHENICIA LTDA",
"supplier_document": "00.469.171\/0003-26",
"senator": {
"id": 41995,
"name": "Alessandro Vieira",
"party": "MDB",
"UF": "SE",
"is_active": 1
}
},
// ...
],
"links": {
// ...
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
// ...
],
"path": "http:\/\/127.0.0.1:8000\/senator-expenses\/senators\/42068\/expenses",
"per_page": 100,
"to": 92,
"total": 92,
"expenses_sum": "18299148.34",
"expenses_avg": "1427.39",
"expenses_count": 12820,
"senators_count": 20,
}
}
Gastos por UF
Lista todos os gastos realizados por senadores de uma determinada Unidade Federativa (UF), com informações detalhadas sobre cada gasto, como data, valor, descrição, tipo de gasto e senador responsável. Esse endpoint é paginado e traz 100 gastos por página.
A chave meta
traz também o valor total dos gastos daquele partido bem como a quantidade total de lançamentos (expenses_sum
, expenses_avg
, expenses_count
).
Atributos opcionais
- Name
year
- Type
- string
- Description
Filtra apenas as despesas do ano específico. Exemplo:
2023
.
Request
curl -G https://apis.codante.io/senator-expenses/uf/SP/expenses
Response
{
"data": [
{
"id": 58147,
"original_id": "2219693",
"date": "2023-12-29T00:00:00.000000Z",
"amount": "320.85",
"expense_category": "Passagens aéreas, aquáticas e terrestres nacionais",
"description": "Companhia Aérea: Aerotur Serviços, Localizador: COWERD. Passageiros: CHRISTIANE GONÇALVES CORRÊA (Matrícula 395903, COMISSIONADO), Voo: 3581 - CGH\/BSB - 04\/03\/24; ",
"supplier": "Aerotur Serviços",
"supplier_document": "05.120.923\/0001-09",
"senator": {
"id": 42147,
"name": "Astronauta Marcos Pontes",
"party": "PL",
"UF": "SP",
"is_active": 1
}
},
// ...
],
"links": {
// ...
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
// ...
],
"path": "http:\/\/127.0.0.1:8000\/senator-expenses\/uf\/SP\/expenses",
"per_page": 100,
"to": 100,
"total": 1412,
"expenses_sum": "937709.96",
"expenses_avg": "664.10",
"expenses_count": 1412,
}
}
Lista de Gastos
Lista todos os gastos realizados pelos senadores, com informações detalhadas sobre cada gasto, como data, valor, descrição, tipo de gasto e senador responsável. Esse endpoint é paginado e traz 100 gastos por página.
Atributos opcionais
Não há filtros neste endpoint, apenas paginação.
Request
curl -G https://apis.codante.io/senator-expenses/expenses
Response
{
"data": [
{
"id": 19628,
"original_id": "2205139",
"date": "2023-07-30T00:00:00.000000Z",
"amount": "240.04",
"expense_category": "Locomoção, hospedagem, alimentação, combustíveis e lubrificantes",
"description": null,
"supplier": "COMERCIO DE COMBUSTIVEIS NEVOEIRO LTDA",
"supplier_document": "95.425.369\/0026-00",
"senator": {
"id": 42072,
"name": "Luis Carlos Heinze",
"party": "PP",
"UF": "RS",
"is_active": 1
}
},
// ...
],
"links": {
// ...
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
// ...
],
"path": "http:\/\/127.0.0.1:8000\/senator-expenses\/expenses",
"per_page": 100,
"to": 100,
"total": 79515,
}
}
Gastos agregados por partido
Este endpoint retorna um resumo dos gastos dos senadores, agrupados por partido político. Ele fornece o total de gastos de cada partido por ano, permitindo uma visão geral dos gastos de cada legenda no Senado.
Os dados estão ordenados por ano e por partido que mais gasta proporcionalmente por senador.
Request
curl -G https://apis.codante.io/senator-expenses/summary/by-party
Response
[
{
"year": "2024",
"data": [
{
"party": "PL",
"senator_ids": [
"42034",
"42177",
"42044",
"42174",
"42012",
"41664",
"42007",
"42164",
"42054",
"42147",
"42081",
"42197",
"41991",
"41977",
"42198",
"42208"
],
"total_expenses": "2993135.9000000064",
"total_per_senator": 187070.9937500004
},
// ...
]
}
]
Gastos agregados por UF
Este endpoint retorna um resumo dos gastos dos senadores, agrupados por Unidade da Federação (UF). Ele fornece informações agregadas sobre o total de gastos em cada estado, permitindo uma visão geral da distribuição dos gastos dos senadores por região do país.
Os dados estão ordenados por ano e por UF que mais gasta proporcionalmente por senador.
Request
curl -G https://apis.codante.io/senator-expenses/summary/by-uf
Response
[
{
"year": "2024",
"data": [
{
"uf": "AP",
"total": "1009351.72"
},
{
"uf": "PE",
"total": "919376.5600000002"
},
{
"uf": "TO",
"total": "564585.9500000002"
},
{
"uf": "DF",
"total": "652850.1200000001"
},
{
"uf": "PI",
"total": "839865.660000001"
},
{
"uf": "SP",
"total": "599339.6200000006"
},
{
"uf": "ES",
"total": "471320.2700000001"
},
{
"uf": "PR",
"total": "438255.8599999996"
},
{
"uf": "PB",
"total": "849619.6799999999"
},
{
"uf": "SC",
"total": "834816.1500000013"
},
{
"uf": "RJ",
"total": "527517.3"
},
{
"uf": "RO",
"total": "818327.4000000004"
},
{
"uf": "BA",
"total": "880209.4900000003"
},
{
"uf": "MA",
"total": "722473.8000000004"
},
{
"uf": "RS",
"total": "756828.4299999996"
},
{
"uf": "MT",
"total": "673281.0700000002"
},
{
"uf": "MG",
"total": "403039.07"
},
{
"uf": "MS",
"total": "703043.9100000004"
},
{
"uf": "GO",
"total": "203140.14"
},
{
"uf": "PA",
"total": "921636.690000001"
},
{
"uf": "AC",
"total": "886059.0600000002"
},
{
"uf": "AM",
"total": "940200.3000000004"
},
{
"uf": "CE",
"total": "632622.4700000003"
},
{
"uf": "SE",
"total": "1078535.7499999995"
},
{
"uf": "RR",
"total": "817916.4400000002"
},
{
"uf": "AL",
"total": "680293.6799999998"
},
{
"uf": "RN",
"total": "785395.3799999999"
}
]
},
// ...
]