iotoms Docs

List ledger accounts

GET
/api/v1/accounting/accounts

Returns your whole chart of accounts as a flat list sorted by code. Each account carries its parentId so you can rebuild the tree. Not paginated.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

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?array<>|

Every ledger account in the chart, sorted by code.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/accounting/accounts' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "code": "string",      "name": "string",      "type": "ASSET",      "reportGroup": "DIRECT_INCOME",      "parentId": "70850378-7d3c-4f45-91b7-942d4dfbbd43",      "currency": "string",      "isGroup": true,      "isControl": true,      "active": true,      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ]}