iotoms Docs

Get the trial balance

GET
/api/v1/accounting/gl/trial-balance

Returns each ledger account's total debits and credits as of asOf (defaults to today), computed from posted journal lines. Grand totals of debits and credits are equal.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Query Parameters

asOf?string

Include postings dated up to and including this date, YYYY-MM-DD. Defaults to today.

Formatdate

Header Parameters

X-TenantID*string

Your merchant's tenant code — the value typed in the Domain field on the iotoms login screen. See Concepts.

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request was processed; otherwise an error status.

message*string

Short human-readable message describing the outcome, e.g. which record was saved or why the call failed.

data?

The trial balance: one row per ledger account plus grand totals.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/accounting/gl/trial-balance' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": {    "asOf": "2019-08-24",    "rows": [      {        "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",        "code": "string",        "name": "string",        "type": "ASSET",        "reportGroup": "DIRECT_INCOME",        "debitMinor": 0,        "creditMinor": 0,        "balanceMinor": 0      }    ],    "totalDebitMinor": 0,    "totalCreditMinor": 0  }}