> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/departamentos/listar-departamentos.md).

# Listar Departamentos

Retorna a **listagem de departamentos** da loja, com suporte a filtro por status e paginação.

```
GET /departamentos/
```

## 🔎 Filtros disponíveis

Os filtros são enviados na **Query** da requisição. Todos são opcionais e podem ser combinados.

| Parâmetro      | Tipo    | Descrição                                             |
| -------------- | ------- | ----------------------------------------------------- |
| `Status`       | texto   | Filtra pelo status: `A` (Ativado) ou `D` (Desativado) |
| `Pagina`       | inteiro | Página desejada (paginação)                           |
| `QtdPorPagina` | inteiro | Registros por página (máx. **100**)                   |

## 📥 Exemplo de requisição

Buscando departamentos **ativos**, 50 por página:

```bash
curl -X GET "https://api.toplojas.com.br/departamentos/?Status=A&QtdPorPagina=50" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"
```

## 📤 Exemplo de resposta

A resposta segue o padrão de paginação (`Dados` + `Paginacao`):

```json
{
  "Dados": [
    {
      "Codigo": 41360,
      "Status": "A",
      "Nome": "Livros 2",
      "Pai": {
        "Codigo": 0,
        "Nome": ""
      }
    }
  ],
  "Paginacao": {
    "PaginaAtual": 1,
    "QtdPaginas": 1,
    "QtdRegistros": 6
  }
}
```

## 📋 Campos retornados

| Campo        | Tipo    | Descrição                                                 |
| ------------ | ------- | --------------------------------------------------------- |
| `Codigo`     | inteiro | Código do departamento                                    |
| `Status`     | texto   | Status do departamento: `A` (Ativado) ou `D` (Desativado) |
| `Nome`       | texto   | Nome do departamento                                      |
| `Pai.Codigo` | inteiro | Código do departamento pai (`0` = departamento raiz)      |
| `Pai.Nome`   | texto   | Nome do departamento pai (vazio quando não há pai)        |

{% hint style="info" %}
Consulte a descrição de cada campo na referência:

{% embed url="<https://api.toplojas.com.br/doc/#/Departamentos>" %}
{% endhint %}

Para entender o funcionamento da paginação, veja:

{% content-ref url="/pages/-MObwaEfNJbBvr8ZSK0U" %}
[Paginação](/funcionamento/paginacao.md)
{% endcontent-ref %}