MonetaryAI / Docs
API ReferenceAccounting settings

Get account configuration

Global accounts not yet configured have version 0. Account code/type are immutable; normal side is derived from type. Company permission: `getCompanyAccount`. Defaults: ADMIN, ACCOUNTANT, VIEWER. Current company role permissions and active membership are checked on every request; signed legacy role claims alone do not authorize this operation.

GET
/api/v1/accounting-settings/{legalEntityId}/accounts/{code}

Authorization

bearerAuth
headerAuthorizationBearer <token>

Obtained from POST /api/v1/auth/login, on the tenant's own subdomain. Presenting it on another tenant's subdomain is a 403.

Path Parameters

legalEntityId*string
Formatuuid
code*string

Response Body

Account returned

application/json
  1. response
balanceType?string
code?string
custom?boolean
enabled?boolean
name?string
normalSide?string
subaccountCount?integer
Formatint64
type?string
Value in"ASSET""CONTRA_ASSET""LIABILITY""EQUITY""INCOME""EXPENSE"
version?integer

0 for an unconfigured global account; send as expectedVersion when configuring

Formatint64
curl -X GET 'https://api.monetaryai.uz/api/v1/accounting-settings/497f6eca-6276-4993-bfeb-53cbbbba6f08/accounts/string'
{  "balanceType": "string",  "code": "string",  "custom": true,  "enabled": true,  "name": "string",  "normalSide": "string",  "subaccountCount": 0,  "type": "ASSET",  "version": 0}

Get inventory, depreciation and tax settings GET

Before first save returns FIFO, STRAIGHT_LINE, null taxRegime/vatRate and version 0. VAT is not guessed from a screenshot or statutory rules. This UI configuration is separate from immutable effective-dated policy/tax records and is not automatically consumed by posting/tax engines. Company permission: `getCompanyAccountingSettings`. Defaults: ADMIN, ACCOUNTANT, VIEWER. Current company role permissions and active membership are checked on every request; signed legacy role claims alone do not authorize this operation.

List direct subaccounts GET

Tenant/company/parent-scoped metadata; not inferred from global NAS sections. Literal search across subaccount code/name, ordered by code/id. Company permission: `listCompanySubaccounts`. Defaults: ADMIN, ACCOUNTANT, VIEWER. Current company role permissions and active membership are checked on every request; signed legacy role claims alone do not authorize this operation.