Accounting Ledger API · postings
Every account's movement over [from
GET /postings/trial-balance
Every account's movement over [from, to), in code order, with the totals: what was debited, what was credited, and the net (debits minus credits — positive for a debit balance such as an asset or an expense, negative for a credit balance such as sales or a liability).
Total debits equal total credits, because every posting balances. This is the period's movement, not a closing balance: open from the opening stocktake for a balance to date. A period's movement carries its period-end revaluation (7110); the next period's carries its reversal. The general ledger begins at the opening stocktake: a period before it moves nothing, and a organization without one has an empty trial balance. The figure a bookkeeper checks against the accounting package, and what an accounting sync reconciles to.
Access
Requires financials:read.
How scopes come from roles: Scopes and roles. Getting a token: Authentication and app tokens.
AI agent tool
Agents call this as accounting_trial_balance (Accounting: Trial balance), in the accounting toolset. It only reads.
Connecting an agent: AI agents.
Example
curl -X GET 'https://accounting.getmanifold.io/postings/trial-balance?from=2026-10-20T00%3A00%3A00.000Z&to=2026-10-21T00%3A00%3A00.000Z' \
-H "Authorization: Bearer $MANIFOLD_TOKEN"const response = await fetch("https://accounting.getmanifold.io/postings/trial-balance?from=2026-10-20T00%3A00%3A00.000Z&to=2026-10-21T00%3A00%3A00.000Z", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.MANIFOLD_TOKEN}` },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const answer = await response.json();{
"from": "2026-10-20T00:00:00.000Z",
"to": "2026-10-21T00:00:00.000Z",
"accounts": [
{
"account": "1200",
"debitCents": 10560,
"creditCents": 0,
"netCents": 10560
},
{
"account": "1400",
"debitCents": 0,
"creditCents": 3400,
"netCents": -3400
},
{
"account": "2200",
"debitCents": 0,
"creditCents": 960,
"netCents": -960
},
{
"account": "4000",
"debitCents": 0,
"creditCents": 9600,
"netCents": -9600
},
{
"account": "5000",
"debitCents": 3400,
"creditCents": 0,
"netCents": 3400
}
],
"debitCents": 13960,
"creditCents": 13960
}The panel writes this call in other languages. It does not send it: Manifold's APIs do not take calls from a web
page on another site, so run the call from your own code or terminal. The whole API as OpenAPI: accounting-manager.openapi.json. Base URL https://accounting.getmanifold.io.
Errors
Every refusal is a status and a JSON body whose _tag names it. A refused call changes nothing.
401
| Refusal | What it means | What to do |
|---|---|---|
Unauthorized reason | The token is missing, expired or not one Manifold issued. | Get a fresh token and send the call again. |
TokenAlreadyUsed tokenId | A single-use app token was already spent. | Mint a new token for this call. |
402
| Refusal | What it means | What to do |
|---|---|---|
SubscriptionRequired status | The organization's subscription has lapsed, so writes are refused. | An owner settles billing. Reads still work meanwhile. |
403
| Refusal | What it means | What to do |
|---|---|---|
TenantRequired userId | The token names no organization. | Choose the organization, then get a new token. |
ScopeRequired required | The token's roles do not grant the scope this call needs. | Ask an owner or admin for a role that grants it. |
409
| Refusal | What it means | What to do |
|---|---|---|
MirroredFromSource source | This area is fed by your source system until the organization goes live. | Make the change in the source system, or go live first. |
503
| Refusal | What it means | What to do |
|---|---|---|
RequestLogUnavailable tokenId, reason | The service could not record the request, so it did nothing. | Try again shortly. |
How refusals work everywhere: Errors.
Used in
- Journal an additional cost on an order, step 19: The trial balance