Product
Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing
Developers

GET STARTED

API DirectoryBrowse 10,000+ APIs Ready For AI Agent IntegrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI Readiness using our scorecardArazzo UIVisualize Arazzo Workflows As Interactive DocumentationArazzo EditorBuild And Edit Multi-Step API Workflows Visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
Resources
Company
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
Resources
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

AICPA SOC for Service Organizations logoAICPA SOC for Service Organizations logo

SOC 2® Type 1 report

Audited by Prescient Assurance

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode
APIs / Finance / ezBookkeeping API
ezBookkeeping API logo

Ezbookkeeping Mayswind ezBookkeeping API

63
AI ReadinessAI-Aware (B-)63/100
See full scorecard
Agent-ready OpenAPI document · curated by JenticFinanceAccountingbearer39 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Manage personal-finance transactions, accounts, categories, tags and tokens on a self-hosted ezBookkeeping deployment via 39 JSON endpoints with bearer-token auth.

Use for: I need to log in to ezBookkeeping and get a bearer token, List all of my ezBookkeeping accounts, Add a new bank account to my ezBookkeeping ledger, Modify an existing account's name or balance

Not supported: Does not handle bank-feed aggregation, tax filing, or multi-tenant SaaS billing - use for self-hosted personal-finance ledger management only.

Jentic publishes the only available OpenAPI specification for ezBookkeeping API, keeping it validated and agent-ready. ezBookkeeping is a self-hosted, open-source personal-finance and bookkeeping app, and the API exposes the full set of operations needed to manage transactions, accounts, categories, tags, and authorisation tokens against a user's deployment. Because it is self-hosted, the host portion of the base URL is supplied per-deployment and bearer tokens are issued by the local /api/authorize.json endpoint.

Jentic One on GithubView OpenAPI Document

Install Jentic One Beta

Connect the ezBookkeeping API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ezBookkeeping API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

1

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fezbookkeeping.mayswind.net%2Fezbookkeeping" | sh
2

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fezbookkeeping.mayswind.net%2Fezbookkeeping" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with ezBookkeeping API.

Authorise a user and obtain a bearer token via /api/authorize.json with optional 2FA

List, add, modify and inspect financial accounts through /api/accounts/list.json and /api/accounts/add.json

Manage personal profile and registration via /api/users/profile/get.json and /api/users/register.json

Revoke individual or all active tokens through /api/tokens/revoke.json and /api/tokens/revoke_all.json

Handle two-factor recovery codes through /api/2fa/recovery.json

Sign in via OAuth2 callback at /api/oauth2/callback.json

Use Cases

Patterns agents use ezBookkeeping API for, with concrete tasks.

★ Self-Hosted Personal Finance Automation

Drive a self-hosted ezBookkeeping deployment from scripts and agents, including login, account management, and token lifecycle. Authorise via /api/authorize.json, optionally exchange a 2FA code through /api/2fa/authorize.json, and use the resulting bearer token to call account, profile and token endpoints. Because hosting is per-user, the {host} placeholder in the base URL must be filled with the deployment's hostname.

POST credentials to https://my-ezbk.example.com/api/authorize.json, then call GET /api/accounts/list.json with the returned bearer token to enumerate accounts.

Account Onboarding Flow

Programmatically register a new ezBookkeeping user, retrieve their profile, and seed the deployment with initial accounts. Use /api/users/register.json to create the user, /api/authorize.json to obtain a token, and /api/accounts/add.json for each starting account. Suitable for households or small teams setting up a shared ezBookkeeping instance from a configuration file.

Call /api/users/register.json with the new user payload, /api/authorize.json to obtain a token, then loop /api/accounts/add.json for each account in the configuration.

Token Hygiene and 2FA Recovery

Maintain account security by listing active tokens, revoking individual stale ones, or rotating all tokens at once with /api/tokens/revoke_all.json. The /api/2fa/recovery.json endpoint supports recovery-code submission when the second factor is unavailable. Useful for households operating shared deployments who need to expire access for departed users.

Call GET /api/tokens/list.json, identify stale tokens, then call /api/tokens/revoke.json for each to revoke them in turn.

Agent-Driven Bookkeeping via Jentic

An AI agent configured for a household's self-hosted ezBookkeeping deployment can use Jentic to discover and call the right endpoints rather than embedding the full client. Bearer tokens issued by /api/authorize.json live in your Jentic One instance, so the agent can list and modify accounts without ever holding the user's password.

Through Jentic, search 'list ezBookkeeping accounts', load /api/accounts/list.json, and execute it against the household deployment's host.

Key Endpoints

39 endpoints — jentic publishes the only available openapi specification for ezbookkeeping api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/api/authorize.json

Authorise a user and return a bearer token

POST

/api/2fa/authorize.json

Submit a 2FA code to complete login

GET

/api/tokens/list.json

List the active tokens for the current user

POST

/api/tokens/revoke_all.json

Revoke all tokens for the current user

GET

/api/accounts/list.json

List financial accounts

POST

/api/accounts/add.json

Add a new financial account

POST

/api/accounts/modify.json

Modify an existing financial account

POST

/api/users/register.json

Register a new ezBookkeeping user

POST

/api/authorize.json

Authorise a user and return a bearer token

POST

/api/2fa/authorize.json

Submit a 2FA code to complete login

GET

/api/tokens/list.json

List the active tokens for the current user

POST

/api/tokens/revoke_all.json

Revoke all tokens for the current user

GET

/api/accounts/list.json

List financial accounts

POST

/api/accounts/add.json

Add a new financial account

POST

/api/accounts/modify.json

Modify an existing financial account

POST

/api/users/register.json

Register a new ezBookkeeping user

Jentic AI Readiness Score

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

E

ezBookkeeping API

- AI-Aware (B-)
63/100
83
Foundational Compliance
63
Developer Experience & Jentic Compatibility
46
AI-Readiness & Agent Experience
94
Agent Usability
60
Security
59
AI Discoverability
Powered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
83

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: ASignals: 4
97%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

35%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

63

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: B-Signals: 4
0%

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

50%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

46

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: DSignals: 4
38%

Description Coverage

Coverage of descriptions across API elements.

0%

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

95%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

50%

Summary Coverage

Coverage of summaries across operations/tags/info.

94

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1
94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

60

Security

Trust, risk posture, and security compliance.

Grade: B-Signals: 1
60%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

59

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: C+Signals: 1
59%

Descriptive Richness

Clarity and depth of descriptions across API elements.

View full reportHow the score is calculatedMore about the dimensions

Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

Score your own APIScoring CLI agent skill
npx @jentic/api-scorecard-cli score <openapi-url>

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the ezBookkeeping API by hand means authorizing through /api/authorize.json, handling its optional 2FA step, pointing at your self-hosted host, and following its .json URL conventions yourself. Through Jentic you install once, import the ezBookkeeping API from the API Directory, store the bearer token once, and your agent calls it.

Permission scoping

ezBookkeeping carries its targets in the request body rather than resource ids in the path, so you limit the agent to the operations it needs, such as listing or adding accounts. You choose those operations, so token-revocation or user-registration calls are not included unless you add them.

Credential isolation

Your ezBookkeeping bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. The user's password and 2FA secret never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'list ezBookkeeping accounts' or 'add a ledger account', and Jentic returns the corresponding /api/accounts operation with its input schema so the agent calls the right endpoint without memorising the .json URL conventions.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Ezus API

→

Travel-agency project, client and invoice management - useful when bookkeeping needs to mirror invoices issued from a separate operations system.

Use Ezus to source invoices and client records, then push the resulting transactions into ezBookkeeping for the household ledger.

Complementary

Exude API Service

→

Light text preprocessing - useful when bookkeeping descriptions need cleanup before search indexing.

Reach for Exude only when transaction notes need stop-word filtering or stemming before being added to a search index.

FAQs

Specific to using ezBookkeeping API through Jentic.

Why is there no official OpenAPI spec for ezBookkeeping API?

ezBookkeeping does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call ezBookkeeping API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the ezBookkeeping API use?

The spec declares an HTTP bearer token scheme. Obtain the token by POSTing credentials to /api/authorize.json (and following up with /api/2fa/authorize.json when 2FA is enabled) and supply it as the Authorization header on subsequent calls; through Jentic the token is held in the vault.

Can I add a new account through the ezBookkeeping API?

Yes. POST the account payload to /api/accounts/add.json with a valid bearer token; you can later modify the same account via /api/accounts/modify.json or list everything with /api/accounts/list.json.

How do I revoke an old token?

Call GET /api/tokens/list.json to find the token id, then POST to /api/tokens/revoke.json with that id; use /api/tokens/revoke_all.json to wipe every active token at once.

How do I list my accounts through Jentic?

Run pip install jentic, search 'list ezBookkeeping accounts', load /api/accounts/list.json, and execute it against your self-hosted host; the bearer token from /api/authorize.json is injected from the vault automatically.

Is the ezBookkeeping API free?

ezBookkeeping is a free, open-source self-hosted project, so the API itself has no licence fee; running costs are limited to whatever infrastructure you choose to host it on.

Can I limit what my agent is allowed to do with the ezBookkeeping API?

Yes. Because you run Jentic One yourself, your own rules decide which ezBookkeeping operations and credentials the agent can use. You can allow just the calls the task needs, such as listing accounts with /api/accounts/list.json or adding one with /api/accounts/add.json, while withholding sensitive operations like token revocation via /api/tokens/revoke_all.json or user registration via /api/users/register.json. Since ezBookkeeping carries its targets in the request body rather than as path resource ids, scoping at the operation level is enough to keep the agent inside those boundaries.

GET STARTED

Start building with ezBookkeeping API

Explore with Jentic One
View OpenAPI Document