Transações

Listar transações

Lista as transações da sua conta, da mais recente para a mais antiga, com filtros por tipo, status, external_id e período.

GET/api/v1/transactions

Query params

Campo	Tipo	Obrigatório	Descrição
`page`	integer	Não	Página, a partir de `1`. Padrão `1`.
`limit`	integer	Não	Itens por página, de `1` a `100`. Padrão `20`.
`type`	enum	Não	`PIX_IN` (cobranças) ou `PIX_OUT` (saques).
`status`	enum	Não	Qualquer um dos status (ex.: `PAID` ou `COMPLETED`).
`external_id`	string	Não	Filtra pelo seu identificador exato.
`from`	string (ISO 8601)	Não	Criadas a partir desta data/hora (inclusive), ex.: `2026-10-01T00:00:00Z`.
`to`	string (ISO 8601)	Não	Criadas até esta data/hora (inclusive).

Os filtros type e status não diferenciam maiúsculas de minúsculas. Valores desconhecidos e datas inválidas retornam 422 validation_error. Cobranças PIX vencidas já aparecem como EXPIRED na listagem. Para acompanhar saques em análise, use type=PIX_OUT&status=AWAITING_APPROVAL.

Resposta

Campo	Tipo	Obrigatório	Descrição
`data`	Transação[]	Sim	Lista de objetos Transação, ordenada por `created_at` decrescente.
`pagination`	object	Sim	Informações de paginação.
`pagination.page`	integer	Sim	Página atual.
`pagination.limit`	integer	Sim	Itens por página.
`pagination.total`	integer	Sim	Total de transações que atendem aos filtros.
`pagination.total_pages`	integer	Sim	Total de páginas (ceil(total / limit)).

Conciliação

Para conciliar um período, percorra as páginas com limit=100 e um intervalo from/to fixo até page > total_pages.

Requisição

curl -X GET "https://reloadbank.app/api/v1/transactions?type=PIX_IN&status=PAID&from=2026-10-01T00:00:00Z&limit=50" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Resposta

{
  "data": [
    {
      "id": "cm2r8x1qz0004lk08abcd1234",
      "external_id": "pedido-1042",
      "type": "PIX_IN",
      "status": "PAID",
      "amount": 100,
      "fee": 1.75,
      "net_amount": 98.25,
      "description": "Pedido #1042",
      "pix": {
        "txid": "K7Q2M9X4T1B8N6R3W5Z0C2V7H",
        "end_to_end_id": "E00000000202610161432K8D2LQ7ZP1M",
        "qr_code": "00020101021226580014br.gov.bcb.pix013600000000-0000-0000-0000-0000000000005204000053039865406100.005802BR5912LOJA EXEMPLO6009SAO PAULO62290525K7Q2M9X4T1B8N6R3W5Z0C2V7H63040000",
        "expires_at": "2026-10-16T15:30:00.000Z"
      },
      "checkout_url": "https://reloadbank.app/pay/cm2r8x1qz0004lk08abcd1234",
      "payer": {
        "name": "Maria Silva",
        "document": "12345678909",
        "email": "[email protected]"
      },
      "failure_reason": null,
      "metadata": {
        "order_id": 1042,
        "channel": "site"
      },
      "paid_at": "2026-10-16T14:32:11.000Z",
      "refunded_at": null,
      "created_at": "2026-10-16T14:30:00.000Z",
      "updated_at": "2026-10-16T14:32:11.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "total_pages": 1
  }
}