UASGs - Unidades Administrativas

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

GET /api/uasgs

Busca UASGs com filtros por UF, municipio, orgao ou texto.

string

Sigla do estado (2 letras). Ex: SP, RJ, DF

string

Nome do municipio para filtrar

number

Codigo do orgao para filtrar

string

Busca por nome (min 3 caracteres)

number

default:"1"

Pagina atual

number

default:"20"

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

GET /api/uasgs/: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
`codigo`	number	Codigo UASG (unico)
`nome`	string	Nome completo da unidade
`uf`	string	Sigla do estado (2 letras)
`municipio`	string	Nome do municipio
`codigoOrgao`	number	Codigo do orgao superior
`nomeOrgao`	string	Nome do orgao
`siglaOrgao`	string	Sigla do orgao