Developers
Build on your BUSY Accounting data
The AI Zeny public API gives your systems 73 read operations over your BUSY data in 16 families, answered by the AI Zeny Windows app on your PC. Version 1 is the current published contract.
12 pages
Developers
DevelopersAI Zeny developer documentation: the public API for BUSY Accounting data, authentication, the response envelope, errors, limits, versioning and the Local API.
Start
QuickstartFrom an organization API token to your first answer from the AI Zeny public API: prerequisites, the request rules and reading the envelope.
Start
AuthenticationHow the AI Zeny public API authenticates: one organization API token per call, optional company scope and expiry, and the refusals you can receive.
API version 1
API version 1AI Zeny public API version 1: the base URL, how requests reach your PC, the response envelope and the request rules every operation shares.
API version 1
OperationsReference for the 73 BUSY operations of AI Zeny API version 1 in 16 families: routes, bodies, paging, answers, errors and examples.
API version 1
ErrorsEvery AI Zeny API version 1 error code once, with its HTTP status, what it means and when a retry can help.
API version 1
Limits and statusCurrent request limits of the AI Zeny public API and known limitations by access path. This is not a live service-status page.
Versions
VersioningHow AI Zeny API versions work: the version in the path, what may change within version 1, and the reserved version 2 pages.
API version 1
ChangelogChanges to the AI Zeny public API, including the envelope change made to four foundation routes before any external customer existed.
On your network
Local APIThe AI Zeny Local API: software on the PC or your private network reads BUSY data through the Windows app, with its own token and the same envelope.
Versions · reserved
API version 2 (reserved)Reserved for AI Zeny public API version 2 documentation. No version 2 documentation or contract is published here.
Versions · reserved
Migrating to v2Reserved for notes on migrating from AI Zeny public API version 1 to a version 2. No version 2 documentation or contract is published here.
Postman API collection
Explore the AI Zeny API documentation and examples in the public Postman collection.
Open the AI Zeny API collection on Postman (external site)What these pages cover
- Quickstart: from a token to your first answer.
- Authentication: organization API tokens, company scope and expiry.
- Version 1 overview: the base URL, the envelope and how requests are relayed.
- Operations: the 15 operation families and their shared conventions.
- Errors: every error code, its status and what to do.
- Limits and status: request limits and known limitations.
- Local API: reading BUSY on your own network, without the cloud.
What is documented today
The API and all of its operations are working. This documentation covers the concepts, conventions, errors and limits every integration needs, and the operations page gives the reference for every operation: its route, body, paging, answer, errors and an example request.
Versions