Skip to content

Accounts

Manage financial accounts (checking, savings, credit cards, etc.).

Create an Account

from finwise import FinWise

client = FinWise(api_key="your-api-key")

account = client.accounts.create(
    name="Savings Account",
    type="savings",
    currency="USD",
    description="Emergency fund",
    initial_balance=10000.00,
)
print(f"Created: {account.id}")

Account Types

Type Description
checking Checking/current account
savings Savings account
credit Credit card
investment Investment/brokerage account
loan Loan account
other Other account type

Retrieve an Account

account = client.accounts.retrieve("acc_123")
print(f"{account.name}: {account.balance}")

Update an Account

account = client.accounts.update(
    "acc_123",
    name="Renamed Account",
    description="Updated description",
)

List Accounts

accounts = client.accounts.list()
for account in accounts:
    print(f"  - {account.name}")

Archive an Account

archived = client.accounts.archive("acc_123")
print(f"Archived at: {archived.archived_at}")

Note

Archiving is a soft delete. The account data is preserved but hidden from normal listings.