Transparência ativa · formatos abertos
Dados Abertos
Consulte e baixe as informações públicas em formatos abertos (CSV, JSON e XML), prontas para planilhas e sistemas. Escolha um conjunto de dados.
Sobre os dados abertos
- Uso livre: os dados podem ser copiados, usados e redistribuídos, citando a fonte (Lei 12.527/2011, art. 8º, §3º, II e III).
- Formatos abertos: CSV (abre no Excel e no LibreOffice), JSON e XML, legíveis por máquina.
- Atualização: os dados vêm direto dos sistemas da entidade; esta página guarda as consultas por até 10 minutos.
- Para sistemas: todos os conjuntos também estão disponíveis por API, explicada abaixo. Ao abrir um conjunto, você vê o endereço, os filtros e exemplos daquele conjunto.
Informações gerais sobre a API
URL Base
https://lai.acessoinformacao.com.br/entidades/pl/ba/barrocas/dados-abertosCada conjunto de dados tem o seu endereço: {URL base}/{conjunto} (ex.: https://lai.acessoinformacao.com.br/entidades/pl/ba/barrocas/dados-abertos/licitacoes). Método GET, sem necessidade de cadastro ou chave de acesso.
Respostas Paginadas
A resposta ao solicitar qualquer recurso poderá ser em formato JSON ou XML, de acordo com o header (cabeçalho) Accept enviado.
Referências JSON:
Os resultados paginados, seguem o seguinte padrão de resposta:
| Propriedade | Tipo | Descrição |
|---|---|---|
total | Number | Quantidade total de Registros |
per_page | Number | Quantidade de items por página |
current_page | Number | Número da Página atual |
last_page | Number | Número da última página |
next_page_url | String | URL da próxima página |
prev_page_url | String | URL da página anterior |
from | Number | Índice do primeiro item da página atual |
to | Number | Índice do último item da página atual |
data | Object[] ou Object | Array de objetos ou único objeto com os dados do recurso solicitado |
- As páginas são numeradas a partir de 1;
- A troca de página é através do parâmetro
page(nota: Para cada página você deve reenviar os filtros que enviou nas páginas anteriores); - A quantidade de registros por página padrão é 15, mas você pode solicitar mais itens com o parâmetro
per_page, sendo que o valor máximo de itens permitido por página é 500.
Headers (cabeçalhos) da Requisição
| Cabeçalho | Resultado |
|---|---|
Accept: application/json | Respostas no formato JSON |
Accept: application/xml | Respostas no formato XML |
Exemplo: curl -H "Accept: application/json" "https://lai.acessoinformacao.com.br/entidades/pl/ba/barrocas/dados-abertos/licitacoes?page=1&per_page=15"
Filtros
Quando houver filtros nos recursos, a URL de requisição deve conter os parâmetros de filtro no padrão query-string (url encoded).
Exemplo:
- Filtro
data_realizacao_startedata_realizacao_end- URL
https://lai.acessoinformacao.com.br/entidades/pl/ba/barrocas/dados-abertos/licitacoes?data_realizacao_start=2025-01-01&data_realizacao_end=2026-11-06
Os filtros de cada recurso (com o formato e as opções aceitas) estão na página de cada conjunto, em "Como usar a API deste conjunto".
Os dados solicitados - Object|Array data
- A propriedade
dataconterá um array ou objeto com o(s) recurso(s) solicitado(s). - Os campos vazios do objeto
data(ou dos seus itens, casodataseja umarray), exemplo""(stringvazia),{}(objectvazio) ou[](arrayvazio) não serão retornados pela API.
Selecione um dos recursos a seguir para visualizar a documentação referente ao data retornado pela API.
Recursos disponíveis
Para recuperar um único registro, use {URL base}/{conjunto}/{id}, onde id é o identificador do registro (quando o conjunto oferece essa consulta). Clique num conjunto para ver o endereço, os filtros e exemplos.
| Conjunto | Endereço (GET) |
|---|---|
| Licitações | /licitacoes |
| Contratos | /contratos |
| Documentos | /documentos |
| Despesas | /despesas |
| Receitas | /receitas |
| Folha de pagamento | /folha-pagamento |
| Obras | /obras |
| Fornecedores | /fornecedores |
| Fiscais de contrato | /fiscais-contrato |
| Terceirizados | /funcionarios |
| Parcerias (MROSC) | /parcerias |
| Patrimônio | /patrimonios |
| Dívida ativa | /dividas-ativas |
| Autoridades | /autoridades |
| Estrutura organizacional | /estrutura-organizacional |
| Carta de serviços | /cartas-servico |
| Diário Oficial | /diarios-oficiais |
| Auxílios esporte | /auxilios-esporte |
| Boletins Covid-19 | /boletins-covid |
Especificação OpenAPI 3 (para geradores de cliente): https://lai.acessoinformacao.com.br/entidades/pl/ba/barrocas/dados-abertos/swagger/specs.json