> 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/pedidos/listar-pedidos.md).

# Listar e Filtrar Pedidos

Retorna a **listagem de pedidos** da loja, com suporte a filtros e paginação.

```
GET /pedidos/
```

## 🔎 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                                           |
| ------------------- | ------- | --------------------------------------------------- |
| `DataDe`            | data    | Retorna pedidos a partir desta data (`Ano-Mês-Dia`) |
| `DataAte`           | data    | Retorna pedidos até esta data (`Ano-Mês-Dia`)       |
| `CodigoReferencial` | inteiro | Filtra pelo código referencial do pedido            |
| `CodigoStatus`      | inteiro | Filtra por um status específico                     |
| `CodigoCliente`     | inteiro | Retorna apenas os pedidos de um cliente             |
| `StatusIndicacao`   | texto   | Filtra por indicação de status (ex.: `Pago`)        |
| `Pagina`            | inteiro | Página desejada (paginação)                         |
| `QtdPorPagina`      | inteiro | Registros por página (máx. **100**)                 |

## 📥 Exemplo de requisição

Buscando pedidos **pagos** entre duas datas, 50 por página:

```bash
curl -X GET "https://api.toplojas.com.br/pedidos/?DataDe=2025-01-01&DataAte=2025-01-31&StatusIndicacao=Pago&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": 1000,
      "CodigoReferencial": 1,
      "Data": "2020-12-01 12:00:00",
      "Loja": "cmacetkoteste",
      "Cliente": {
        "Codigo": 1,
        "IsPessoa": "F",
        "Nome_RazaoSocial": "Paloma Macetko",
        "Contato": "",
        "DataNascimento": "1989-11-14",
        "Sexo": "M",
        "CPF_CNPJ": "000.000.000-00",
        "RG_IE": "",
        "Email": "suporte2@web4business.com.br",
        "Telefone01": "(47) 33224477",
        "Telefone02": "(47) 55447788",
        "Telefone03": "(47) 55886699",
        "Empresa": "",
        "End_Estado": "SC",
        "End_Cidade": "Brusque",
        "End_Bairro": "centro",
        "End_Endereco": "Rua Central",
        "End_Numero": "99",
        "End_Complemento": "",
        "End_CEP": "88355-000"
      },
      "Endereco": {
        "End_Estado": "SC",
        "End_Cidade": "Brusque",
        "End_Bairro": "centro",
        "End_Endereco": "Rua Central",
        "End_Numero": "99",
        "End_Complemento": "",
        "End_CEP": "88355-000"
      },
      "ValorTotal": 253.79,
      "ValorProdutos": 220,
      "ValorFrete": 33.79,
      "ValorDescontosCupom": 0,
      "ValorDescontosPagamento": 0,
      "FormaPagamento": {
        "Codigo": 78509,
        "Nome": "PagSeguro"
      },
      "FormaEntrega": {
        "Codigo": 27154,
        "Nome": "PAC"
      },
      "NumeroParcelas": 1,
      "Status": {
        "Codigo": 25,
        "Nome": "Pedido com Pagamento Confirmado, Aguardando Captura",
        "Indicacao": "Pago"
      },
      "FormasEntregaCalculadas": [
        {
          "Codigo": 27150,
          "Nome": "Frete Grátis",
          "Valor": 0,
          "PrazoEntrega": {
            "QtdDias": 12,
            "Texto": "Entrega em até <strong>12 dias</strong> úteis após a postagem"
          }
        },
        {
          "Codigo": 27154,
          "Nome": "PAC",
          "Valor": 33.79,
          "PrazoEntrega": {
            "QtdDias": 9,
            "Texto": "Entrega em até <strong>9 dias</strong> úteis após a postagem"
          }
        },
        {
          "Codigo": 27155,
          "Nome": "SEDEX",
          "Valor": 52.4,
          "PrazoEntrega": {
            "QtdDias": 4,
            "Texto": "Entrega em até <strong>4 dias</strong> úteis após a postagem"
          }
        }
      ],
      "Itens": [
        {
          "Codigo": 1187876,
          "SKU": "3017",
          "Nome": "Teste1",
          "Quantidade": 2,
          "ValorUnitario": 110,
          "ValorTotal": 220
        }
      ]
    }
  ],
  "Paginacao": {
    "PaginaAtual": 1,
    "QtdPaginas": 1,
    "QtdRegistros": 4
  }
}
```

{% hint style="info" %}
Cada pedido da listagem também traz o elemento **`FormasEntregaCalculadas`**, com todas as opções de frete calculadas no carrinho (ordenadas do menor para o maior valor, incluindo **frete grátis** com `Valor` igual a **0**). Veja os detalhes desse elemento em:
{% endhint %}

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

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

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

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