Docs menu

Accounting Ledger API · postings

A page of the general ledger

GET /postings

A page of the general ledger, newest effective date first (posting id breaking ties): one balanced double-entry posting per fact that moved money, with its debit and credit lines by account code.

Narrow by account (a code any line posts to), source (what kind of fact posted it — receipt, opening-stock, opening-stocktake, opening-balances, stocktake-variance, cogs, cogs-correction, cogs-reversal, write-down, supplier-invoice, landed-cost, sales-invoice, payment, refund, payout, supplier-payment, shipping-cost, shipping-cost-void, carrier-payment, revaluation, revaluation-reversal, cash-recognition, basis-change), orderId, payoutId (a payout's own postings: their 7100 lines are its realised exchange), sku, and a period — from inclusive, to exclusive, on the effective date. total counts every match; limit is 1–500 (100 when omitted). Stock in debits the SKU's inventory account against goods-received-not-invoiced; a supplier invoice moves that accrual to accounts payable and lands the price difference on stock and cost of sales; a dispatch debits cost of sales and credits inventory; a sales invoice debits receivables for its total against the lines' revenue accounts, shipping income, tax payable and discounts; a payment moves receivables into its provider's clearing account (undeposited funds when taken by hand); a refund is a deduction from sales out of that clearing; a payout relieves the clearing of what it settles and lands its fees, chargebacks, reserves and exchange, leaving the clearing holding the deposit. On the cash basis an invoice's revenue and tax, and a bill's expense and tax, post to 2300 / 1350 instead, and cash-recognition moves them out as money settles them. Every line is in the home currency — a line converted from another currency also carries its currency and amountCents there, at the rate its fact captured, and a settlement's rate difference is realised exchange (7100). At each period end (a calendar month period ending at midnight in the books' zone, tax settings' timeZone) a revaluation restates the open foreign-currency receivables, payables and clearing at that day's reference rate against unrealised exchange (7110), on the period's last instant, and its revaluation-reversal undoes it on the next period's first. Codes are the chart's (GET /accounts on inventory): a SKU's three from its master data, the control accounts fixed per organization. The general ledger begins at the opening stocktake: it posts the counted stock at its cost against opening balances, nothing effective before it is the ledger's, and before it the page is empty. Served from accounting's incrementally folded ledger, like /ledger.

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_list_postings (Accounting: List postings), in the accounting toolset. It only reads.

Connecting an agent: AI agents.

Example

curl 
curl -X GET 'https://accounting.getmanifold.io/postings?orderId=ord_01a156d4-8704-7a21-8b32-4c5d6e7f8091&from=2026-10-20T00%3A00%3A00.000Z&to=2026-10-21T00%3A00%3A00.000Z&limit=100' \
  -H "Authorization: Bearer $MANIFOLD_TOKEN"
JavaScript (fetch) 
const response = await fetch("https://accounting.getmanifold.io/postings?orderId=ord_01a156d4-8704-7a21-8b32-4c5d6e7f8091&from=2026-10-20T00%3A00%3A00.000Z&to=2026-10-21T00%3A00%3A00.000Z&limit=100", {
  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();
Response · 200 · application/json 
{
  "items": [
    {
      "postingId": "pst_01a1588b-1a20-7b31-9c42-132435465768",
      "source": "sales-invoice",
      "occurredAt": "2026-10-20T03:15:00.000Z",
      "effectiveAt": "2026-10-20T03:15:00.000Z",
      "lines": [
        {
          "account": "1200",
          "debitCents": 10560,
          "creditCents": 0
        },
        {
          "account": "4000",
          "debitCents": 0,
          "creditCents": 9600,
          "sku": "MUG-SPECKLE",
          "lineId": "lin_01a156d4-8704-7a21-8b32-5d6e7f809102"
        },
        {
          "account": "2200",
          "debitCents": 0,
          "creditCents": 960,
          "tax": {
            "class": "standard",
            "treatment": "domestic",
            "country": "AU",
            "rateBps": 1000,
            "exempt": false
          }
        }
      ],
      "orderId": "ord_01a156d4-8704-7a21-8b32-4c5d6e7f8091",
      "invoiceId": "inv_01a1588b-1a20-7b31-9c42-7f8091021324",
      "memo": "invoice inv_01a1588b-1a20-7b31-9c42-7f8091021324 on ord_01a156d4-8704-7a21-8b32-4c5d6e7f8091"
    },
    {
      "postingId": "pst_01a1588b-1a20-7b31-9c42-243546576879",
      "source": "cogs",
      "occurredAt": "2026-10-20T03:15:00.000Z",
      "effectiveAt": "2026-10-20T03:15:00.000Z",
      "lines": [
        {
          "account": "5000",
          "debitCents": 3400,
          "creditCents": 0,
          "sku": "MUG-SPECKLE",
          "lineId": "lin_01a156d4-8704-7a21-8b32-5d6e7f809102"
        },
        {
          "account": "1400",
          "debitCents": 0,
          "creditCents": 3400,
          "sku": "MUG-SPECKLE",
          "lineId": "lin_01a156d4-8704-7a21-8b32-5d6e7f809102"
        }
      ],
      "orderId": "ord_01a156d4-8704-7a21-8b32-4c5d6e7f8091",
      "sku": "MUG-SPECKLE",
      "memo": "cogs (fifo)"
    }
  ],
  "total": 2,
  "limit": 100,
  "offset": 0
}

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

RefusalWhat it meansWhat 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

RefusalWhat it meansWhat to do
SubscriptionRequired status The organization's subscription has lapsed, so writes are refused.An owner settles billing. Reads still work meanwhile.

403

RefusalWhat it meansWhat 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

RefusalWhat it meansWhat 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

RefusalWhat it meansWhat 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