Listar transferências
curl --request GET \
--url https://api.upag.io/v1/transfers \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.upag.io/v1/transfers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.upag.io/v1/transfers';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));Transferências Pix
Listar transferências
Lista as transferências da conta, mais recentes primeiro
GET
https://api.upag.io
/
v1
/
transfers
Listar transferências
curl --request GET \
--url https://api.upag.io/v1/transfers \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.upag.io/v1/transfers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.upag.io/v1/transfers';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));Lista as transferências da conta, nas duas direções (entrada e saída), da mais recente para a mais antiga. Use
Campos em Referência.
direction para filtrar.
Permissão: transfer.read. Apenas chave secreta (sk_…).
Os exemplos usam o sandbox (
https://api.upag.dev/v1). Em produção use https://api.upag.io/v1 com sk_live_….Endpoint
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"
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,
});
Parâmetros
string
in (Pix recebido) ou out (Pix enviado). Sem o filtro, traz as duas. Valor desconhecido retorna 422.integer
default:"1"
Página, a partir de 1.
integer
default:"15"
Itens por página, mínimo 1.
Resposta
200 OK. count é o total de transferências da conta.
Response
{
"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
}