Developers & API
Everything the app can do, you can do from a script. Same endpoints, your own API key.
Anatomy of an API request
GET https://bareledger.app/api/v1/reports/trial-balance Authorization: Bearer <your API key> X-Tenant: <organization id> Accept: application/json
- 1One base URL, one version. Everything lives under
/api/v1/, the same endpoints the web and mobile apps use. - 2Your API key is the bearer token. Create it under My profile → API keys. It acts as you, with your permissions.
- 3Say which organization. The tenant header picks the set of books. Copy the id from Organization settings (masked until you confirm an emailed code); only organizations you are registered in are ever visible.
- 4JSON in, JSON out. Predictable pagination, ISO-8601 dates, and a consistent error shape.
API Overview
Start here to learn which API endpoints are public, how the rest are grouped, and how to make your first call.
Read guideAPI Access
Create a user-bound API key, choose read-only or read & write, and make your first call.
Read guideAPI Authentication
Bearer tokens, login with two-factor, token lifetime, and what a permission error looks like.
Read guideAPI Conventions
Base URL, pagination, dates and timezones, filtering, status codes, validation errors, and rate limits.
Read guideAuthorization
The gates every request passes: token scope, organization, subscription, permission, plan limits, country.
Read guideAPI Error Reference
Every HTTP status the API returns, what each one means in BareLedger, the body shape to expect, and what to do next.
Read guideIntegration Examples
Worked curl examples: authenticate, page through results, handle errors, verify a webhook.
Read guideWebhooks
The inbound billing webhooks, how signatures are verified, and what is not there yet.
Read guideEndpoint reference
Every endpoint group, with methods, paths, permissions, and side effects.
Auth & Onboarding
Register, log in with or without two-factor, manage sessions, and create your first organization — the calls every integration starts with.
Read guide ReferenceOrganization & Team
Organization settings, branches, departments and projects, team members, roles and per-member access overrides.
Read guide ReferenceChart of Accounts & Periods
Create and manage your chart of accounts, accounting periods, numbering sequences, and exchange rates via the API.
Read guide ReferenceJournal Entries
Create, submit, review, approve and reverse manual journal entries, and read the workflow history behind each one.
Read guide ReferenceSales & Receivables
Contacts, products, quotations, sales orders, invoices, credit and debit notes.
Read guide ReferencePurchases & Payables
Bills, vendor credits, supplier payments and recurring bills — record what you owe and settle it through the approval workflow.
Read guide ReferenceExpenses API
Create, submit, review, approve and reverse expense records, attach receipts, and read an expense back with its workflow history.
Read guide ReferenceBank & Reconciliation API
Bank accounts, statement imports, reconciliation sessions, suggested matches and bank rules, in the order a reconciliation actually runs.
Read guide ReferenceReports API
Every financial report endpoint — trial balance, ledger, statements, aging, tax summary — with filters and export formats.
Read guide ReferenceBilling & Subscriptions
Plans, checkout, subscription state, usage against plan limits, add-ons and billing invoices for your own BareLedger subscription.
Read guide ReferenceCompliance & Tax API
Statutory filings, tax registrations, withholding certificates and e-invoice files — generate, override, finalize and mark filed.
Read guide ReferenceAttachments
Upload, list, download and delete the files attached to invoices, bills, expenses and journals, with the size and type limits that apply.
Read guide ReferenceAudit & Meta
Query the append-only audit trail by record, actor or date, plus the metadata endpoints that describe how your organization is configured.
Read guide