beancount-gocardless

A Python client for the GoCardless Bank Account Data API (formerly Nordigen), featuring Pydantic models and a Beancount importer.

Overview

beancount-gocardless provides an integration between the GoCardless Bank Account Data API and Beancount. It includes:

• API Client: Typed client using Pydantic models for endpoints and data structures.

• CLI Tool: Interactive interface to manage bank connections.

• Beancount Importer: A beangulp importer that fetches transactions and converts them into Beancount directives.

Prerequisites

You need a GoCardless Bank Account Data account to obtain your API credentials (secret_id and secret_key). Sign up at GoCardless Bank Account Data.

Installation

pip install beancount-gocardless

The project requires Python 3.9+.

Contents:

• API Client
  • Features
  • Usage
  • Reference
• CLI Tool
  • Usage
  • Configuration
  • Interactive Features
  • Mock Mode
• Beancount Importer
  • Configuration
  • Usage
  • Extensibility
  • Reference