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.


GET/senators

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

GET
/senators
  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
    }
  ]
}

GET/senators/{senatorId}/expenses

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

GET
/senators/{senatorId}/expenses
  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
  }
}

GET/parties

Lista de Partidos

Lista todos os partidos políticos dos senadores. Traz apenas a sigla do partido.

Request

GET
/parties
  curl -G https://apis.codante.io/senator-expenses/parties

Response

{
  "data": [
    {
      "id": "AVANTE"
    },
    {
      "id": "CIDADANIA"
    },
    // ...
  ]
}

GET/parties/{partyId}/expenses

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

GET
/parties/{partyId}/expenses
  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,
  }
}

GET/uf/{uf}/expenses

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

GET
/uf/{uf}/expenses
  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,
  }
}

GET/expenses

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

GET
/expenses
  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,
  }
}

GET/summary/by-party

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

GET
/summary/by-party
  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
      },
      // ...  
    ]
  }
]

GET/summary/by-uf

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

GET
/summary/by-uf
  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"
      }
    ]
  },
  // ...
]