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

# Listar transferências

> Lista as transferências da conta, mais recentes primeiro

Lista as transferências da conta, nas duas direções (entrada e saída), da mais recente para a mais antiga. Use `direction` para filtrar.

Permissão: `transfer.read`. Apenas chave secreta (`sk_…`).

<Note>
  Os exemplos usam o sandbox (`https://api.upag.dev/v1`). Em produção use `https://api.upag.io/v1` com `sk_live_…`.
</Note>

## Endpoint

<CodeGroup>
  ```bash cURL theme={null}
  curl -G https://api.upag.dev/v1/transfers \
    -H "Authorization: Bearer sk_test_your_api_key" \
    -d "direction=out" \
    -d "page=1" \
    -d "limit=15"
  ```

  ```javascript Node.js SDK theme={null}
  import { Upag } from 'upag';

  const upag = new Upag('sk_test_your_api_key');

  const { data, count } = await upag.transfers.list({
    direction: 'out',
    page: 1,
    limit: 15,
  });
  ```
</CodeGroup>

## Parâmetros

<ParamField query="direction" type="string">
  `in` (Pix recebido) ou `out` (Pix enviado). Sem o filtro, traz as duas. Valor desconhecido retorna `422`.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Página, a partir de 1.
</ParamField>

<ParamField query="limit" type="integer" default="15">
  Itens por página, mínimo 1.
</ParamField>

## Resposta

`200 OK`. `count` é o total de transferências da conta.

```json Response theme={null}
{
  "data": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "status": "completed",
      "direction": "out",
      "type": "key",
      "amount": 10000,
      "pixKey": "55ce1aae-0d2b-4d76-bc77-294d6407349e",
      "pixKeyType": "random",
      "from": {
        "name": "Acme LTDA",
        "taxNumber": "12345678000199",
        "bankName": "Upag"
      },
      "to": {
        "name": "Maria Receiver",
        "taxNumber": "111.444.777-35",
        "bankName": "FitBank"
      },
      "endToEndId": "E12345678202603181200000000000000",
      "providerTransactionId": "555",
      "url": null,
      "createdAt": "2026-03-18T12:00:00.000Z",
      "updatedAt": "2026-03-18T12:01:00.000Z"
    }
  ],
  "count": 1
}
```

Campos em [Referência](./reference).


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