Definições da API DADOS ABERTOS

23/04/2026

O acesso aos dados abertos de Dotações é feito através de nossa API, que consiste em endereços na Internet (URL) prontos para serem aproveitados por outros aplicativos. É possível realizar consultas através da passagem de parâmetros, com os dados sendo disponibilizados nos formatos XML, JSON e CSV.
 

URL Básica
Para acessar os dados é preciso conhecer a URL básica e o formato dos parâmetros.

URL:

Para Dotações:  https://iris.tcm.sp.gov.br/assets/data/dotacao/Dotacao{anoReferencia}.{formato}

Para Receita:      https://iris.tcm.sp.gov.br/assets/data/receita/csvReceita{anoReferencia}.zip

Para Empenho: https://iris.tcm.sp.gov.br/assets/data/empenho/Empenho{anoReferencia}.zip

Onde:

  • {anoReferencia} - ano das informações que serão consultadas (valor obrigatório)
  • {formato} - formato do resultado que será apresentado (valor obrigatório)

 

Atenção:

  • Somente os dados de entrada podem ser usados para fazer consultas;
  • Verifique a documentação de cada método para saber se existem parâmetros obrigatórios.

Exemplo

Exemplos de consultas utilizando a API de Dados Abertos:

Exemplo 1: Para listar os dados abertos de Dotação de 2026 no formato XML, utilize a seguinte url: https://iris.tcm.sp.gov.br/assets/data/dotacao/Dotacao2026.xml

Exemplo 2: Para listar os dados abertos de Dotação de 2025 no formato CSV, utilize a seguinte url: https://iris.tcm.sp.gov.br/assets/data/dotacao/Dotacao2025.csv, e o arquivo ficará disponível para download.

Exemplo 3: Para listar os dados abertos de Receita de 2026 no formato CSV, utilize a seguinte url: https://iris.tcm.sp.gov.br/assets/data/receita/csvReceita2026.zip, e o arquivo ficará disponível para download.

Exemplo 4: Para listar os dados abertos de Empenho de 2026 no formato CSV, utilize a seguinte url: https://iris.tcm.sp.gov.br/assets/data/empenho/Empenho2026.zip, e o arquivo ficará disponível para download.