> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bukiopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Pedidos

> Lista os pedidos da sua loja com paginação, filtro por situação, busca e intervalo de datas.

Retorna os pedidos da sua loja, do mais recente para o mais antigo.

**Método:** `GET /api/v1/orders`

**Autenticação:** Obrigatória — inclua o header `Authorization: Bearer sk_live_sua_api_key`.

## Parâmetros de query

<ParamField query="limit" default="50" type="number">
  Pedidos por página. Máximo: `100`.
</ParamField>

<ParamField query="offset" default="0" type="number">
  Pedidos a pular, para paginação.
</ParamField>

<ParamField query="status" type="string">
  `pending`, `paid`, `shipped`, `cancelled` ou `refunded`.
</ParamField>

<ParamField query="search" type="string">
  Busca por nome do cliente, e-mail ou código do pedido.
</ParamField>

<ParamField query="dateFrom" type="string">
  Data ISO inicial, inclusiva.
</ParamField>

<ParamField query="dateTo" type="string">
  Data ISO final, exclusiva.
</ParamField>

<ParamField query="productIds" type="string">
  UUIDs de produtos separados por vírgula. Retorna só pedidos que contenham ao menos um deles.
</ParamField>

## Exemplo de requisição

```bash theme={null}
curl -X GET 'https://api.bukiopay.com/api/v1/orders?status=paid&limit=20' \
  --header 'Authorization: Bearer sk_live_sua_api_key'
```

## Resposta

```json theme={null}
{
  "orders": [
    {
      "id": "8159fbe2-fd7d-4b28-8028-1257210b32d0",
      "orderCode": "2IH180IE7K3M9P4Q6R",
      "status": "paid",
      "total": 149.9,
      "customerName": "Maria Silva",
      "customerEmail": "maria@exemplo.com",
      "payerName": "João Silva",
      "items": [
        {
          "productId": "9d40e409-28e6-481f-aafc-83f97b831f07",
          "variantId": null,
          "name": "Produto Exemplo",
          "quantity": 1,
          "price": 149.9
        }
      ],
      "createdAt": "2026-08-26T11:58:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 137
  }
}
```

<Note>
  `total` e `price` são **em reais**, com decimais. `149.9` = R\$149,90.
</Note>

## Cliente e pagador

<ResponseField name="customerName" type="string">
  Quem comprou, informado no checkout. Use este campo para identificar o comprador.
</ResponseField>

<ResponseField name="payerName" type="string">
  Titular da conta que pagou o Pix, informado pelo banco. Difere de `customerName` quando outra pessoa paga.
</ResponseField>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.