API
Transactions
Double-entry journal entries — list, create, retrieve, delete.
A transaction is a journal entry: two or more lines that sum to zero. Created, listed, and deleted via the API.
Object shape
{
"id": "01HW…",
"object": "transaction",
"date": "2026-05-24",
"memo": "Hosting sale — Acme Co",
"reference": "INV-1024",
"lines": [
{
"id": "01HW…",
"account": "01HW…",
"debit": "120000",
"credit": "0",
"memo": null
},
{
"id": "01HW…",
"account": "01HW…",
"debit": "0",
"credit": "120000",
"memo": null
}
],
"created_at": "2026-05-24T12:00:00.000Z",
"updated_at": "2026-05-24T12:00:00.000Z"
}Amounts are minor units as strings. "120000" USD = $1,200.00.
Endpoints
GET /v1/transactions ?account=:id (filter by account)
POST /v1/transactions { date, memo?, reference?, lines: [...] }
GET /v1/transactions/:id
DELETE /v1/transactions/:idCreate
Each line must have exactly one of debit or credit greater than
zero. Amounts may be passed as decimal strings ("1200.00") or
minor-unit strings ("120000"). Total debits must equal total credits
or the request fails with 400 and code: "unbalanced".
curl -X POST https://axerity.com/api/v1/transactions \
-H "Authorization: Bearer $AX_KEY" \
-H "Content-Type: application/json" \
-d '{
"date": "2026-05-24",
"memo": "Hosting sale — Acme Co",
"reference": "INV-1024",
"lines": [
{ "account": "01HW…CASH", "debit": "1200.00" },
{ "account": "01HW…REVENUE", "credit": "1200.00" }
]
}'Validation errors to expect
unbalanced— total debit ≠ total credit.- Generic 400 — a line with both debit and credit, or zero amounts, or a closed period (the date you supplied is inside a locked period).
not_found_error—accountid not in your org.
→ Reports