Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ata360.com.br/llms.txt

Use this file to discover all available pages before exploring further.

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:
UASGNomeUF
153015Universidade de Sao PauloSP
200330Ministerio da EconomiaDF
110161Presidencia da RepublicaDF

​
Endpoints

​
Buscar UASGs

GET /api/uasgs
Busca UASGs com filtros por UF, municipio, orgao ou texto.
​
uf
string
Sigla do estado (2 letras). Ex: SP, RJ, DF
​
municipio
string
Nome do municipio para filtrar
​
orgao
number
Codigo do orgao para filtrar
​
q
string
Busca por nome (min 3 caracteres)
​
page
number
default:"1"
Pagina atual
​
limit
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

# Todas UASGs de Minas Gerais
curl ".../api/uasgs?uf=MG"

curl ".../api/uasgs?q=universidade%20federal"

# 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

CampoTipoDescricao
codigonumberCodigo UASG (unico)
nomestringNome completo da unidade
ufstringSigla do estado (2 letras)
municipiostringNome do municipio
codigoOrgaonumberCodigo do orgao superior
nomeOrgaostringNome do orgao
siglaOrgaostringSigla do orgao