Acessibilidade

Brasão

Prefeitura Municipal DE Itanhomi - MG

PORTAL DATRANSPARÊNCIA

Exercício:
Início

Documentação da API de Dados Abertos

GET JSON Público Sem autenticação Paginado

Esta API pública permite consultar dados reais do Portal da Transparência em formato estruturado e reutilizável. A API é somente leitura, aceita apenas método GET e retorna sempre JSON.

O parâmetro exercicio é obrigatório em todos os endpoints. A paginação retorna no máximo 12 registros por página.

Resumo dos endpoints

Recurso Endpoint
Servidores https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/servidores
Receitas https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/receitas
Empenhos https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/empenhos
Liquidações https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/liquidacoes
Pagamentos https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/pagamentos
Extraorçamentárias https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/extraorcamentarias
Diárias de Viagens https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/diarias
Convênios https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/convenios
Consórcios https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/consorcios
Dispensas e Inexigibilidades https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/dispensas-e-inexigibilidades
Licitações https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/licitacoes
Contratos https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/contratos
Folha de Pagamento https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/folha-pagamento

Autenticação e acesso

Não é necessário token de autenticação. O cliente é identificado automaticamente pelo domínio/subdomínio do portal.

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/servidores?exercicio=2025&page=1

Paginação

Todos os endpoints são paginados em 12 itens por página. Use o parâmetro page para navegar.

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [],
    "meta": {
        "current_page": 1,
        "per_page": 12,
        "total": 60,
        "total_pages": 5,
        "returned": 12
    },
    "links": {
        "first": "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/servidores?exercicio=2025&page=1",
        "last": "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/servidores?exercicio=2025&page=5",
        "prev": null,
        "next": "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/servidores?exercicio=2025&page=2"
    }
}

Status HTTP

  • 200 - Consulta realizada com sucesso.
  • 400 - Parâmetro inválido ou obrigatório ausente.
  • 404 - Endpoint não encontrado ou nenhum registro encontrado.
  • 405 - Método não permitido para a API de leitura.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno ao processar a consulta.
{
  "success": false,
  "message": "O parâmetro exercicio é obrigatório.",
  "errors": {
    "exercicio": ["Informe o exercício da consulta."]
  }
}
{
  "success": false,
    "message": "Limite de requisições excedido. Tente novamente em instantes.",
    "blocked_until": "2026-05-15 15:30:00"
}
{
    "success": false,
    "message": "API temporariamente indisponível devido ao alto volume de requisições. Tente novamente mais tarde.",
    "blocked_until": "2026-05-15 15:40:00"
}

Proteção de Dados e LGPD

A API retorna apenas dados públicos já exibidos no Portal da Transparência. Dados pessoais são mascarados quando necessário e informações sensíveis não são disponibilizadas.

  • CPF é sempre mascarado no padrão público do portal.
  • CNPJ segue o padrão público de exibição do sistema.
  • Senha, token, dados bancários, endereço pessoal, telefone pessoal e e-mail pessoal não são retornados.
  • Campos técnicos internos e metadados privados não são expostos na API pública.
  • Os exemplos desta documentação já seguem o padrão de mascaramento.
{
  "cpf": "***.304.446-**",
  "cpf_cnpj": "***.123.456-**",
  "credor": "Fornecedor Exemplo LTDA"
}

Limites de Uso e Proteção da API

A API possui proteção automática contra uso excessivo, abuso e alto volume de tráfego. Em excesso por IP, o acesso é bloqueado temporariamente com aumento progressivo do tempo de bloqueio. Em excesso global, a API pode ficar temporariamente indisponível para proteção da infraestrutura.

  • HTTP 429: limite excedido para o IP solicitante.
  • HTTP 503: proteção global ativa por alto volume agregado.
  • Recomendado: usar paginação, cache no cliente e intervalos entre requisições.

Exemplo de resposta 429

{
    "success": false,
    "message": "Limite de requisições excedido. Tente novamente em instantes.",
    "blocked_until": "2026-05-15 15:30:00"
}

Exemplo de resposta 503

{
    "success": false,
    "message": "API temporariamente indisponível devido ao alto volume de requisições. Tente novamente mais tarde.",
    "blocked_until": "2026-05-15 15:40:00"
}

Parâmetros gerais

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Ano da consulta.
data_inicial Não data (YYYY-MM-DD) Filtra registros a partir da data informada.
data_final Não data (YYYY-MM-DD) Filtra registros até a data informada.
page Não inteiro Página da consulta. Padrão: 1.

Faixas de valor para pagamentos: ate_1000, 1000_2000, 2000_3000, 3000_5000, acima_5000.

Situações de servidores aceitas: ativo, inativo e códigos públicos do sistema.

Servidores

GET JSON

Consulta dados públicos de servidores e vínculos.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/servidores

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
matricula Não texto Filtra por matrícula do servidor/vínculo e retorna apenas os registros correspondentes.
nome Não texto Filtra por nome do servidor/entidade usando correspondência textual.
cpf Não texto Filtra por CPF (valor é mascarado no retorno conforme padrão público).
situacao Não texto Filtra pela situação do registro (ex.: ativo, inativo, vigente, cadastro inicial).
cargo Não texto Filtra por cargo/função informada no registro.
lotacao Não texto Filtra por unidade/setor de lotação.
vinculo Não texto Filtra por tipo de vínculo do servidor.
faixa_salarial Não texto Filtra por faixa de remuneração conforme códigos públicos definidos na API.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/servidores?exercicio=2025&matricula=123&situacao=ativo&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/servidores?exercicio=2025&matricula=123&situacao=ativo&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/servidores?exercicio=2025&matricula=123&situacao=ativo&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "nome": "Joao da Silva",
            "matricula": "010000000000002",
            "cpf": "***.304.446-**",
            "cargo": "VEREADOR(A)",
            "situacao": "Ativo",
            "lotacao": "CAMARA MUNICIPAL",
            "vinculo": "Agente politico",
            "remuneracao": 4095.07,
            "data_referencia": "2025-02-01"
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Receitas

GET JSON

Consulta receitas arrecadadas com filtros por natureza, origem e valores.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/receitas

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
tipo Não texto Filtra por tipo/classificação do registro conforme o endpoint consultado.
origem Não texto Filtra por origem da receita/arrecadação.
natureza Não texto Filtra por código de natureza orçamentária/receita/despesa.
descricao Não texto Filtra por texto da descrição/objeto do registro.
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/receitas?exercicio=2025&natureza=11145111&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/receitas?exercicio=2025&natureza=11145111&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/receitas?exercicio=2025&natureza=11145111&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "codigo_receita": "11145111",
            "natureza": "11145111",
            "descricao": "1.1.1.4.51.1.1 - Imposto sobre Bens Imoveis",
            "valor": 18250.99,
            "data": "2025-03-01"
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Empenhos

GET JSON

Consulta empenhos por número, tipo, credor, elemento e faixa de valores.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/empenhos

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
numero_empenho Não texto Filtra pelo número do empenho.
tipo_empenho Não texto Filtra pela classificação do empenho (ordinário, global, estimativo etc.).
credor Não texto Filtra pelo nome do credor/fornecedor favorecido.
cpf_cnpj Não texto Filtra por documento do favorecido (retorno segue máscara/padrão público).
dotacao Não texto Filtra pela dotação orçamentária vinculada ao lançamento.
elemento_despesa Não texto Filtra pelo código/descrição do elemento de despesa.
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/empenhos?exercicio=2025&numero_empenho=50&data_inicial=2025-01-01&data_final=2025-03-01&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/empenhos?exercicio=2025&numero_empenho=50&data_inicial=2025-01-01&data_final=2025-03-01&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/empenhos?exercicio=2025&numero_empenho=50&data_inicial=2025-01-01&data_final=2025-03-01&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "numero_empenho": "50",
            "data": "2025-01-10",
            "tipo_empenho": "Lancamento em despesas, exceto Servico da Divida",
            "modalidade_empenho": "Ordinario",
            "credor": "Empresa Exemplo LTDA",
            "cpf_cnpj": "00.000.000\/0001-00",
            "historico": "Aquisicao de materiais de consumo",
            "valor": 1500
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Liquidações

GET JSON

Consulta liquidações com filtros por número, empenho, credor e valores.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/liquidacoes

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
numero_liquidacao Não texto Filtra pelo número da liquidação.
numero_empenho Não texto Filtra pelo número do empenho.
credor Não texto Filtra pelo nome do credor/fornecedor favorecido.
cpf_cnpj Não texto Filtra por documento do favorecido (retorno segue máscara/padrão público).
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/liquidacoes?exercicio=2025&numero_liquidacao=10&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/liquidacoes?exercicio=2025&numero_liquidacao=10&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/liquidacoes?exercicio=2025&numero_liquidacao=10&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "numero_liquidacao": "10",
            "numero_empenho": "50",
            "data": "2025-01-20",
            "credor": "Empresa Exemplo LTDA",
            "cpf_cnpj": "00.000.000\/0001-00",
            "valor": 1200
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Pagamentos

GET JSON

Consulta pagamentos com filtros por OP, empenho, tipo, credor e faixa de valor.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/pagamentos

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
numero_pagamento Não texto Filtra pelo número da ordem de pagamento/documento de pagamento.
numero_empenho Não texto Filtra pelo número do empenho.
tipo_pagamento Não texto Filtra pela classificação do pagamento.
credor Não texto Filtra pelo nome do credor/fornecedor favorecido.
cpf_cnpj Não texto Filtra por documento do favorecido (retorno segue máscara/padrão público).
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.
faixa_valor Não texto Filtra por faixa pré-definida de valor (ex.: 1000_2000, acima_5000).

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/pagamentos?exercicio=2025&faixa_valor=1000_2000&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/pagamentos?exercicio=2025&faixa_valor=1000_2000&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/pagamentos?exercicio=2025&faixa_valor=1000_2000&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "numero_pagamento": "123",
            "numero_empenho": "50",
            "tipo_pagamento": "Pagamento de despesa, exceto Servico da Divida",
            "credor": "Empresa Exemplo LTDA",
            "cpf_cnpj": "00.000.000\/0001-00",
            "data": "2025-01-22",
            "valor": 1200,
            "historico": "Pagamento de nota fiscal"
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Extraorçamentárias

GET JSON

Consulta lançamentos extraorçamentários por tipo, descrição, credor e valores.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/extraorcamentarias

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
tipo Não texto Filtra por tipo/classificação do registro conforme o endpoint consultado.
descricao Não texto Filtra por texto da descrição/objeto do registro.
credor Não texto Filtra pelo nome do credor/fornecedor favorecido.
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/extraorcamentarias?exercicio=2025&tipo=01&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/extraorcamentarias?exercicio=2025&tipo=01&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/extraorcamentarias?exercicio=2025&tipo=01&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "codigo": "100",
            "tipo": "Depositos e Consignacoes (natureza credora)",
            "descricao": "Retencao de consignacoes",
            "valor": 3500,
            "data": "2025-02-01"
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Diárias de Viagens

GET JSON

Consulta diárias a partir dos empenhos de natureza específica.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/diarias

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
servidor Não texto Filtra pelo nome do servidor no endpoint consultado.
cargo Não texto Filtra por cargo/função informada no registro.
destino Não texto Filtra por local de destino da viagem/diária.
motivo Não texto Filtra por texto do motivo/histórico da diária.
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/diarias?exercicio=2025&servidor=joao&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/diarias?exercicio=2025&servidor=joao&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/diarias?exercicio=2025&servidor=joao&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "servidor": "Joao da Silva",
            "cargo": null,
            "destino": null,
            "motivo": "Diaria de viagem para reuniao institucional",
            "numero_empenho": "88",
            "data": "2025-03-03",
            "valor": 600
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Convênios

GET JSON

Consulta convênios firmados com filtros por número, concedente, objeto, situação e valores.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/convenios

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
numero_convenio Não texto Filtra pelo número identificador do convênio.
concedente Não texto Filtra pelo órgão/entidade concedente do recurso.
convenente Não texto Filtra pela entidade convenente.
objeto Não texto Filtra por texto do objeto da contratação, convênio ou processo.
situacao Não texto Filtra pela situação do registro (ex.: ativo, inativo, vigente, cadastro inicial).
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/convenios?exercicio=2025&numero_convenio=10&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/convenios?exercicio=2025&numero_convenio=10&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/convenios?exercicio=2025&numero_convenio=10&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "numero_convenio": "10",
            "concedente": "Ministerio Exemplo",
            "convenente": "Orgao Municipal",
            "objeto": "Apoio financeiro para projeto social",
            "situacao": "Vigente",
            "data_assinatura": "2025-01-15",
            "valor": 250000
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Consórcios

GET JSON

Consulta consórcios públicos por CNPJ, situação, objeto e faixa de valor.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/consorcios

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
nome Não texto Filtra por nome do servidor/entidade usando correspondência textual.
cnpj Não texto Filtra por CNPJ da entidade/consórcio.
objeto Não texto Filtra por texto do objeto da contratação, convênio ou processo.
situacao Não texto Filtra pela situação do registro (ex.: ativo, inativo, vigente, cadastro inicial).
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/consorcios?exercicio=2025&cnpj=00000000000100&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/consorcios?exercicio=2025&cnpj=00000000000100&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/consorcios?exercicio=2025&cnpj=00000000000100&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "nome": "Consorcio Intermunicipal Exemplo",
            "cnpj": "00.000.000\/0001-00",
            "objeto": "Saude",
            "situacao": "Ativo",
            "valor": 50000,
            "data_referencia": "2025-02-01"
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Dispensas e Inexigibilidades

GET JSON

Consulta processos de dispensa e inexigibilidade.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/dispensas-e-inexigibilidades

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
numero_processo Não texto Filtra pelo número do processo administrativo/licitatório.
modalidade Não texto Filtra pela modalidade do processo (licitação, dispensa, inexigibilidade etc.).
tipo Não texto Filtra por tipo/classificação do registro conforme o endpoint consultado.
objeto Não texto Filtra por texto do objeto da contratação, convênio ou processo.
fornecedor Não texto Filtra pelo nome do fornecedor/contratado.
cpf_cnpj Não texto Filtra por documento do favorecido (retorno segue máscara/padrão público).
situacao Não texto Filtra pela situação do registro (ex.: ativo, inativo, vigente, cadastro inicial).
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/dispensas-e-inexigibilidades?exercicio=2025&tipo=1&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/dispensas-e-inexigibilidades?exercicio=2025&tipo=1&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/dispensas-e-inexigibilidades?exercicio=2025&tipo=1&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "numero_processo": "007",
            "modalidade": "Lei 14.133\/2021",
            "tipo": "Dispensa",
            "objeto": "Contratacao de servico tecnico",
            "fornecedor": "Fornecedor Exemplo LTDA",
            "cpf_cnpj": "00.000.000\/0001-00",
            "situacao": "Cadastro inicial",
            "valor": 9500,
            "data": "2025-02-12"
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Licitações

GET JSON

Consulta licitações por processo, modalidade, objeto, situação e valor.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/licitacoes

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
numero_processo Não texto Filtra pelo número do processo administrativo/licitatório.
modalidade Não texto Filtra pela modalidade do processo (licitação, dispensa, inexigibilidade etc.).
objeto Não texto Filtra por texto do objeto da contratação, convênio ou processo.
situacao Não texto Filtra pela situação do registro (ex.: ativo, inativo, vigente, cadastro inicial).
fornecedor Não texto Filtra pelo nome do fornecedor/contratado.
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/licitacoes?exercicio=2025&modalidade=6&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/licitacoes?exercicio=2025&modalidade=6&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/licitacoes?exercicio=2025&modalidade=6&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "numero_processo": "005",
            "modalidade": "Pregao Eletronico",
            "objeto": "Aquisicao de equipamentos",
            "situacao": "Cadastro inicial",
            "fornecedor": null,
            "valor": 125000,
            "data": "2025-01-28"
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Contratos

GET JSON

Consulta contratos por número, contratado, situação e valores.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/contratos

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
numero_contrato Não texto Filtra pelo número do contrato.
contratado Não texto Filtra pelo nome da parte contratada.
cpf_cnpj Não texto Filtra por documento do favorecido (retorno segue máscara/padrão público).
objeto Não texto Filtra por texto do objeto da contratação, convênio ou processo.
situacao Não texto Filtra pela situação do registro (ex.: ativo, inativo, vigente, cadastro inicial).
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/contratos?exercicio=2025&numero_contrato=4&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/contratos?exercicio=2025&numero_contrato=4&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/contratos?exercicio=2025&numero_contrato=4&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "numero_contrato": "004\/2025",
            "contratado": "Fornecedor Exemplo LTDA",
            "cpf_cnpj": "00.000.000\/0001-00",
            "objeto": "Aquisicao de impressoras",
            "situacao": "Vigente",
            "valor": 12005,
            "data_publicacao": "2025-02-03"
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Folha de Pagamento

GET JSON

Consulta da folha de pagamento por servidor, competência, vínculo e faixa salarial.

URL: https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/folha-pagamento

Parâmetro Obrigatório Tipo Descrição
exercicio Sim inteiro (AAAA) Obrigatório. Define o ano-base da consulta e retorna somente registros desse exercício.
data_inicial Não data (YYYY-MM-DD) Filtra registros com data igual ou posterior ao valor informado (YYYY-MM-DD).
data_final Não data (YYYY-MM-DD) Filtra registros com data igual ou anterior ao valor informado (YYYY-MM-DD).
page Não inteiro Define a página da paginação. Cada página retorna até 12 registros.
matricula Não texto Filtra por matrícula do servidor/vínculo e retorna apenas os registros correspondentes.
servidor Não texto Filtra pelo nome do servidor no endpoint consultado.
cpf Não texto Filtra por CPF (valor é mascarado no retorno conforme padrão público).
cargo Não texto Filtra por cargo/função informada no registro.
lotacao Não texto Filtra por unidade/setor de lotação.
vinculo Não texto Filtra por tipo de vínculo do servidor.
competencia Não texto Filtra pela competência da folha (ex.: MM/AAAA).
faixa_salarial Não texto Filtra por faixa de remuneração conforme códigos públicos definidos na API.
valor_minimo Não decimal Retorna apenas registros com valor igual ou maior que este parâmetro.
valor_maximo Não decimal Retorna apenas registros com valor igual ou menor que este parâmetro.

Exemplo de requisição

https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/folha-pagamento?exercicio=2025&competencia=02/2025&page=1

Exemplo em cURL

curl -X GET "https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/folha-pagamento?exercicio=2025&competencia=02/2025&page=1" \
  -H "Accept: application/json"

Exemplo em JavaScript fetch

fetch("https://pmitanhomi.gwtransparencia.com.br/api/dados-abertos/folha-pagamento?exercicio=2025&competencia=02/2025&page=1", {
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo de resposta JSON

{
    "success": true,
    "message": "Consulta realizada com sucesso.",
    "data": [
        {
            "matricula": "010000000000002",
            "servidor": "Joao da Silva",
            "cpf": "***.304.446-**",
            "cargo": "VEREADOR(A)",
            "lotacao": "CAMARA MUNICIPAL",
            "vinculo": "Agente politico",
            "competencia": "02\/2025",
            "faixa_salarial": "3000_5000",
            "valor": 4095.07,
            "data_referencia": "2025-02-01"
        }
    ]
}

Possíveis erros

  • 400 - Parâmetros inválidos ou ausentes.
  • 404 - Nenhum registro encontrado.
  • 429 - Limite de requisições excedido.
  • 500 - Erro interno.

Prefeitura Municipal de Itanhomi - MG

Av. Juscelino Kubitscheck, nº 91 - Centro - CEP 35.120-000 - Itanhomi - MG

Telefone: (33) 3231-1345 - Email: [email protected]

Segunda a sexta-feira, das 08h às 17h

GW Transparência
Última Atualização: 05/06/2026 18:20:14