Base URL e Autenticação
Base URL
https://api.betim.mg.gov.br/v1Autenticação
Não requerida (APIs públicas abertas)Rate Limit
60 requisições/minuto por IPFormato
JSON (application/json)CORS
Permitido de qualquer origemEndpoints de Despesas
GET
/despesasLista despesas municipais com filtros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| ano | integer | Não | Exercício (padrão: ano atual) |
| mes | integer | Não | Mês 1-12 |
| secretaria | string | Não | Slug da secretaria |
| natureza | string | Não | Natureza da despesa |
| page | integer | Não | Página (padrão: 1) |
| per_page | integer | Não | Itens por página (máx: 100) |
Exemplo de Resposta
{
"data": [
{
"id": "2024-DEP-00001",
"data": "2024-01-15",
"secretaria": "Secretaria de Saúde",
"descricao": "Aquisição de medicamentos",
"natureza": "Material de Consumo",
"funcao": "Saúde",
"valor_empenhado": 150000.00,
"valor_liquidado": 150000.00,
"valor_pago": 150000.00,
"favorecido": "Farmácia XYZ Ltda",
"cnpj": "12.345.678/0001-90"
}
],
"meta": {
"total": 5432,
"page": 1,
"per_page": 20,
"last_page": 272
}
}GET
/despesas/{id}Retorna despesa específica por ID
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | string | Sim | Identificador único da despesa |
GET
/despesas/totaisTotais agregados por secretaria e natureza
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| ano | integer | Não | Exercício |
| secretaria | string | Não | Slug da secretaria |
Endpoints de Receitas
GET
/receitasLista receitas municipais com filtros de origem e período
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| ano | integer | Não | Exercício |
| mes | integer | Não | Mês 1-12 |
| origem | string | Não | tributaria, transferencias, outras |
| page | integer | Não | Página (padrão: 1) |
Exemplo de Resposta
{
"data": [
{
"id": "2024-REC-00001",
"data": "2024-01-10",
"descricao": "IPTU — Cota Única",
"origem": "tributaria",
"categoria": "Impostos",
"valor_previsto": 5000000.00,
"valor_arrecadado": 4850000.00,
"percentual_execucao": 97.0
}
],
"meta": { "total": 1205, "page": 1, "per_page": 20 }
}Endpoints de Servidores
GET
/servidoresLista servidores públicos municipais com dados de remuneração
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| secretaria | string | Não | Filtra por secretaria |
| vinculo | string | Não | efetivo, comissionado, temporario |
| page | integer | Não | Página (padrão: 1) |
Exemplo de Resposta
{
"data": [
{
"id": "SRV-001",
"nome": "J*** S***",
"cargo": "Analista de Sistemas",
"secretaria": "Secretaria de Administração",
"vinculo": "Efetivo",
"carga_horaria": 40,
"remuneracao_bruta": 8500.00,
"remuneracao_liquida": 6200.00
}
],
"meta": { "total": 4856, "page": 1, "per_page": 20 }
}!
Nomes parcialmente anonimizados em cumprimento à LGPD. Dados completos disponíveis via SIC.
Endpoints de Licitações
GET
/licitacoesLista processos licitatórios com filtros por modalidade e status
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| modalidade | string | Não | pregao, concorrencia, dispensa, inexigibilidade |
| status | string | Não | aberta, encerrada, revogada, anulada |
| ano | integer | Não | Exercício |
| page | integer | Não | Página (padrão: 1) |
Códigos de Status HTTP
| Código | Descrição |
|---|---|
| 200 OK | Requisição bem-sucedida |
| 400 Bad Request | Parâmetros inválidos |
| 404 Not Found | Recurso não encontrado |
| 429 Too Many Requests | Rate limit excedido |
| 500 Internal Server Error | Erro no servidor |
Versionamento
| Versão | Status | Suporte até |
|---|---|---|
| v1 (atual) | Ativa | Indefinido |
| v0 (legada) | Depreciada | Jun/2025 |
SDKs e Bibliotecas
Python
pip install betim-apiJavaScript
npm install betim-transparencyR
install.packages("betimData")Dúvidas ou sugestões? apis@betim.mg.gov.br — Veja também Exemplos de Uso