> ## 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.

# UASGs - Unidades Administrativas

> Como consultar unidades administrativas do governo

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

```bash theme={null}
GET /api/uasgs
```

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

<ParamField query="uf" type="string">
  Sigla do estado (2 letras). Ex: SP, RJ, DF
</ParamField>

<ParamField query="municipio" type="string">
  Nome do municipio para filtrar
</ParamField>

<ParamField query="orgao" type="number">
  Codigo do orgao para filtrar
</ParamField>

<ParamField query="q" type="string">
  Busca por nome (min 3 caracteres)
</ParamField>

<ParamField query="page" type="number" default="1">
  Pagina atual
</ParamField>

<ParamField query="limit" type="number" default="20">
  Itens por pagina (max 100)
</ParamField>

**Exemplos:**

```bash theme={null}
# 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

```bash theme={null}
GET /api/uasgs/:codigo
```

Retorna uma UASG especifica pelo codigo.

**Exemplo:**

```bash theme={null}
curl "https://api.ata360.com.br/api/uasgs/153015" \
  -H "Authorization: Bearer $API_KEY"
```

**Resposta:**

```json theme={null}
{
  "codigo": 153015,
  "nome": "UNIVERSIDADE DE SAO PAULO",
  "uf": "SP",
  "municipio": "SAO PAULO",
  "codigoOrgao": 26231,
  "nomeOrgao": "UNIVERSIDADE DE SAO PAULO",
  "siglaOrgao": "USP"
}
```

## Resposta de Lista

```json theme={null}
{
  "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

<AccordionGroup>
  <Accordion title="Encontrar UASGs de um estado">
    ```bash theme={null}
    # Todas UASGs de Minas Gerais
    curl ".../api/uasgs?uf=MG"
    ```
  </Accordion>

  <Accordion title="Buscar universidades federais">
    ```bash theme={null}
    curl ".../api/uasgs?q=universidade%20federal"
    ```
  </Accordion>

  <Accordion title="UASGs de um orgao especifico">
    ```bash theme={null}
    # Primeiro, encontre o codigo do orgao
    curl ".../api/uasgs?q=ministerio%20saude"

    # Depois, liste todas UASGs do orgao
    curl ".../api/uasgs?orgao=36000"
    ```
  </Accordion>
</AccordionGroup>

## 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             |