UASG (Unidade Administrativa de Servicos Gerais) e o codigo que identifica cada unidade do governo que realiza compras publicas. O ATA360 possui mais de 21.000 UASGs cadastradas.
O que e uma UASG?
Cada orgao, autarquia, fundacao ou unidade do governo possui um codigo UASG unico. Este codigo e usado em todos os processos de compras publicas.
Exemplos:
UASG Nome UF 153015 Universidade de Sao Paulo SP 200330 Ministerio da Economia DF 110161 Presidencia da Republica DF
Endpoints
Buscar UASGs
Busca UASGs com filtros por UF, municipio, orgao ou texto.
Sigla do estado (2 letras). Ex: SP, RJ, DF
Nome do municipio para filtrar
Codigo do orgao para filtrar
Busca por nome (min 3 caracteres)
Itens por pagina (max 100)
Exemplos:
# UASGs de Sao Paulo
curl ".../api/uasgs?uf=SP&limit=5" \
-H "Authorization: Bearer $API_KEY "
# Buscar por nome
curl ".../api/uasgs?q=universidade&limit=5" \
-H "Authorization: Bearer $API_KEY "
# UASGs de um municipio
curl ".../api/uasgs?uf=RJ&municipio=RIO%20DE%20JANEIRO" \
-H "Authorization: Bearer $API_KEY "
Obter UASG por Codigo
Retorna uma UASG especifica pelo codigo.
Exemplo:
curl "https://api.ata360.com.br/api/uasgs/153015" \
-H "Authorization: Bearer $API_KEY "
Resposta:
{
"codigo" : 153015 ,
"nome" : "UNIVERSIDADE DE SAO PAULO" ,
"uf" : "SP" ,
"municipio" : "SAO PAULO" ,
"codigoOrgao" : 26231 ,
"nomeOrgao" : "UNIVERSIDADE DE SAO PAULO" ,
"siglaOrgao" : "USP"
}
Resposta de Lista
{
"data" : [
{
"codigo" : 153015 ,
"nome" : "UNIVERSIDADE DE SAO PAULO" ,
"uf" : "SP" ,
"municipio" : "SAO PAULO" ,
"codigoOrgao" : 26231 ,
"nomeOrgao" : "UNIVERSIDADE DE SAO PAULO" ,
"siglaOrgao" : "USP"
}
],
"pagination" : {
"page" : 1 ,
"limit" : 5 ,
"total" : 2500 ,
"totalPages" : 500
}
}
Casos de uso
Encontrar UASGs de um estado
# Todas UASGs de Minas Gerais
curl ".../api/uasgs?uf=MG"
Buscar universidades federais
curl ".../api/uasgs?q=universidade%20federal"
UASGs de um orgao especifico
# Primeiro, encontre o codigo do orgao
curl ".../api/uasgs?q=ministerio%20saude"
# Depois, liste todas UASGs do orgao
curl ".../api/uasgs?orgao=36000"
Estrutura de dados
Campo Tipo Descricao codigonumber Codigo UASG (unico) nomestring Nome completo da unidade ufstring Sigla do estado (2 letras) municipiostring Nome do municipio codigoOrgaonumber Codigo do orgao superior nomeOrgaostring Nome do orgao siglaOrgaostring Sigla do orgao