Get balance

GET/v1/balance

Returns the current balance of the INFI account.

Response `200 OK`

{
  "available": 124530,
  "pending": 0,
  "currency": "BRL",
  "updatedAt": 1715000000000
}

Field	Description
`available`	Account gross balance, in cents. Does not subtract active precautionary holds (see Callout below).
`pending`	Reserved for future use. Always `0` today.
`currency`	Always `"BRL"`.
`updatedAt`	Unix timestamp in milliseconds at the moment of the response.

Heads up: `available` may not match the withdrawable amount

If the account has active precautionary holds (e.g., Bacen MED, dispute, administrative block), the actually withdrawable amount is available − sum of active holds. A withdrawal attempt above that limit returns 422 Saldo insuficiente.

Eventual consistency

After a charge or withdrawal is confirmed, available reflects the new amount within a few seconds. For fine-grained reconciliation, use GET /v1/transactions/:id.

Examples

curl https://api.internationalfinance.com.br/v1/balance \
  -H "Authorization: Bearer $INFI_API_KEY"

const res = await fetch('https://api.internationalfinance.com.br/v1/balance', {
  headers: { Authorization: `Bearer ${process.env.INFI_API_KEY}` },
})
const balance = await res.json()
console.log('R$', (balance.available / 100).toFixed(2))

import os, requests
 
res = requests.get(
    "https://api.internationalfinance.com.br/v1/balance",
    headers={"Authorization": f"Bearer {os.environ['INFI_API_KEY']}"},
)
balance = res.json()
print(f"R$ {balance['available'] / 100:.2f}")

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

Get a transaction Setting up

Get balance

Response 200 OK

Examples

Response `200 OK`