Skip to main content

​
What is Monzoh?

Monzoh is a Python library that makes it easy to work with the Monzo Developer API. It enables developers to build applications that interact with their Monzo bank account.

Type-Safe

Built with Pydantic models for complete type safety and validation

Full API Coverage

Comprehensive coverage of all Monzo API endpoints and features

OAuth2 Authentication

Simple OAuth2 flow with automatic token management

Error Handling

Comprehensive error handling with custom exception types

​
Features

  • Full Monzo API Coverage: Access all Monzo API endpoints including accounts, transactions, pots, attachments, receipts, webhooks, and feed items
  • Type-Safe: Built with Pydantic models for complete type safety and runtime validation
  • Simple OAuth2: Easy-to-use OAuth2 authentication flow with automatic token management
  • Comprehensive Error Handling: Custom exception types for different API error conditions
  • Mock Mode: Built-in mock data for testing without API calls
  • Well-Tested: Comprehensive test suite with high code coverage

​
Quick Example

from monzoh import MonzoClient

# Initialize client with OAuth2 authentication
client = MonzoClient()

# List all accounts
accounts = client.accounts.list()
print(f"Found {len(accounts)} accounts")

# Get account balance
balance = client.accounts.get_balance(account_id=accounts[0].id)
print(f"Balance: {balance.balance / 100:.2f} {balance.currency}")

# List recent transactions
transactions = client.transactions.list(
    account_id=accounts[0].id,
    limit=10
)
for transaction in transactions:
    print(f"{transaction.description}: {transaction.amount / 100:.2f}")

​
API Coverage

Monzoh provides comprehensive coverage of the Monzo API:
FeatureStatusDescription
OAuth2 Authentication✅Complete OAuth2 flow with token management
Accounts✅List accounts and get balance information
Transactions✅List, retrieve, and annotate transactions
Pots✅Manage savings pots and transfers
Attachments✅Upload and manage transaction attachments
Receipts✅Add detailed receipt information to transactions
Webhooks✅Register and manage webhook endpoints
Feed Items✅Create custom feed items

​
Installation

Install Monzoh using your preferred package manager: 
pip install monzoh

​
Requirements

  • Python 3.9 or higher
  • A Monzo developer account and OAuth2 credentials
  • Internet connection for API calls (unless using mock mode)

​
Get Started

Ready to start building with Monzoh? Check out our quickstart guide to get up and running in minutes.
⌘I