> ## 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 Cobranças

> Lista as cobranças da sua loja com filtro por tipo, situação, busca e intervalo de datas.

Retorna as cobranças e movimentações da sua loja.

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

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

## Parâmetros de query

<ParamField query="type" type="string">
  `PIX_IN` para cobranças recebidas, `PIX_OUT` para saques enviados.
</ParamField>

<ParamField query="status" type="string">
  `PENDING`, `COMPLETED`, `CANCELLED` ou `FAILED`.
</ParamField>

<ParamField query="has_products" type="boolean">
  `false` traz só cobranças avulsas; `true`, só cobranças de pedidos.
</ParamField>

<ParamField query="search" type="string">
  Busca por referência, pagador, cliente, documento ou descrição.
</ParamField>

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

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

<ParamField query="limit" default="20" type="number">
  Cobranças por página.
</ParamField>

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

## Exemplo de requisição

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

## Resposta

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "e19dc9a3-7e3d-4c4a-8e72-9ca5c17540c2",
      "type": "PIX_IN",
      "status": "COMPLETED",
      "amount": 50,
      "feeAmount": 2.49,
      "netAmount": 47.51,
      "description": "Mensalidade de agosto",
      "externalReference": "2IH180IE",
      "createdAt": "2026-08-26T11:58:00.000Z",
      "paidAt": "2026-08-26T12:00:00.000Z"
    }
  ],
  "requestId": "req_a1b2c3d4"
}
```

<Note>
  Valores **em reais**, com decimais. `50` = R\$50,00.
</Note>


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