List transactions

GET/v1/transactions

Lists charges and withdrawals for the account, sorted by creation date (most recent first).

Query parameters

Name	Type	Description
`type`	string	Filter by type: `pix_in` (charges) or `withdrawal` (withdrawals). Without the parameter, returns both.
`limit`	integer	Page size. Default `50`, maximum `100`.

There is no cursor pagination today. For larger datasets, query specific transactions through GET /v1/transactions/:id or process them in windows using your own transactionId history.

Response `200 OK`

{
  "transactions": [
    {
      "transactionId": "Q4t9aV...",
      "type": "pix_in",
      "amountCents": 1000,
      "feeCents": 10,
      "netCents": 990,
      "status": "paid",
      "externalRef": "pedido-123",
      "pixPayload": "00020126580014BR.GOV.BCB.PIX...",
      "expiresAt": 1715000000,
      "paidAt": 1714999100000,
      "createdAt": 1714998000000,
      "updatedAt": 1714999100000
    }
  ],
  "count": 1
}

Field	Description
`transactionId`	Transaction ID.
`type`	`"pix_in"` or `"withdrawal"`.
`amountCents`, `feeCents`, `netCents`	Values in cents.
`status`	See Status.
`externalRef`	The identifier you provided at creation.
`pixPayload`	PIX copy-and-paste (only in `pix_in`).
`expiresAt`	Unix timestamp in seconds (charges).
`paidAt`, `createdAt`, `updatedAt`	Unix timestamp in milliseconds.
`endToEndId`	(optional) BACEN-standard E2E ID, present in settled transactions (`paid`/`refunded`).
`payer`	(optional) Payer data in `pix_in` that received payment — `{ name, document, documentType, bankAccount: { ispb, branch, account } }`. See Events.
`beneficiary`	(optional) Beneficiary data in `withdrawal` that settled — same structure as `payer`.
`refundEndToEndId`	(optional) E2E ID of the refund PIX, in returned withdrawals.

Heads up: expiresAt is in seconds; paidAt, createdAt and updatedAt are in milliseconds.

The endToEndId, payer, beneficiary and refundEndToEndId fields are optional — omitted from the JSON when the transaction has not settled yet (pending, processing, failed, cancelled, expired).

Examples

curl "https://api.internationalfinance.com.br/v1/transactions?type=pix_in&limit=20" \
  -H "Authorization: Bearer $INFI_API_KEY"

const params = new URLSearchParams({ type: 'pix_in', limit: '20' })
const res = await fetch(`https://api.internationalfinance.com.br/v1/transactions?${params}`, {
  headers: { Authorization: `Bearer ${process.env.INFI_API_KEY}` },
})
const { transactions } = await res.json()

import os, requests
 
res = requests.get(
    "https://api.internationalfinance.com.br/v1/transactions",
    headers={"Authorization": f"Bearer {os.environ['INFI_API_KEY']}"},
    params={"type": "pix_in", "limit": 20},
)
data = res.json()

<?php
$client = new GuzzleHttp\Client();
$res = $client->get('https://api.internationalfinance.com.br/v1/transactions', [
  'headers' => ['Authorization' => 'Bearer ' . getenv('INFI_API_KEY')],
  'query'   => ['type' => 'pix_in', 'limit' => 20],
]);
$data = json_decode($res->getBody(), true);

List authorized recipients Get a transaction

List transactions

Query parameters

Response 200 OK

Examples

Response `200 OK`