Browse the extensions reference

accountRegister

returns AccountRegister

One entity's posted lines on one account, oldest first, each with the balance it leaves.

The lines run from an opening balance to a closing one, which is the trial balance's for the same window added to the opening. An income or expense account's opening counts from the fiscal year's start.

Arguments

NameTypeDescription
accountIdString!The account.
startDateDateStart of the window (inclusive). Omit from the first line.
endDateDateEnd of the window (inclusive). Omit through the last line.
entityIdStringThe entity whose books to read. Omit for the group parent.
dimensionTypeStringA management dimension axis to slice by, with dimension_member_id.
dimensionMemberIdStringThe one member whose lines to read, or unallocated for the lines no member of the axis tags.
flowElementIdStringOnly the lines tagged to this cash flow or equity movement row.
includeDraftsBoolean! = falseAlso return the window's draft lines, outside every balance.
afterStringThe nextCursor of the page before.
limitIntMaximum rows to return, 1-1000. Omit to use this field's own default; out of range raises INVALID_PAGINATION.

Returns AccountRegister

One account's lines over a window, each with the balance it leaves. closingBalance is openingBalance plus the window's lines, and equals the trial balance's net for the same entity, account and window added to the opening. A page carries its own pageOpeningBalance, so reading one page needs none before it.

FieldTypeDescription
accountRegisterAccount!The account read.
entityIdStringThe entity whose books were read.
startDateDateThe window's first day; null from the first line.
endDateDateThe window's last day; null through the last line.
openingFromDateThe day the opening balance counts from: the fiscal year's start for an income or expense account, null (inception) for any other.
openingBalanceFloat!The balance before the window's first line, natural sign.
totalDebitsFloat!The window's debits, in dollars.
totalCreditsFloat!The window's credits, in dollars.
closingBalanceFloat!The balance after the window's last line, natural sign. A window spanning fiscal years carries an income or expense account's balance across the year end rather than resetting it.
lineCountInt!How many lines the window holds.
pageOpeningBalanceFloat!The balance before this page's first line, natural sign.
lines[RegisterLine!]!This page's lines, oldest first.
nextCursorStringPass as after for the next page; null on the last.
drafts[RegisterLine!]!With include_drafts, on the first page only: the window's draft lines on the account, oldest first and at most a page of them, outside every balance above.
draftsTruncatedBoolean!True when the window holds more drafts than drafts lists.
slicedBoolean!True when read for one management dimension member, its axis's Unallocated, or one flow row: the balances are that slice's, not the account's.

Example

query
{ accountRegister(accountId: "...", includeDrafts: true) { entityId startDate endDate openingFrom } }
curl
curl -X POST "https://api.robosystems.ai/extensions/$GRAPH_ID/graphql" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ accountRegister(accountId: \"...\", includeDrafts: true) { entityId startDate endDate openingFrom } }"}'