> ## Documentation Index > Fetch the complete documentation index at: https://entendre.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get trial balance > Returns cumulative balances: the opening balance plus the activity through the end period. Send `start_date` and `end_date`, or `as_of=true` with `end_date`. A window with no matching accounting periods is rejected. ## OpenAPI ````yaml openapi-public-preview.json GET /v1/reports/trial-balance openapi: 3.1.0 info: title: Entendre API version: 1.0.0 description: Programmatic access to crypto-native accounting and treasury operations. servers: - url: https://api.entendre.finance description: Production API. security: - ApiKey: [] tags: - name: Organization description: Read your organization profile and find members for agent assignments. - name: Transactions description: Find transactions, inspect their details and create manual records. - name: Sources description: >- Manage wallets, exchange accounts, bank accounts and other transaction sources. - name: Assets description: Inspect asset acquisitions, remaining quantities and cost basis. - name: Journals description: >- Create and post journal entries, correct eligible entries and sync posted journals to a connected general ledger. - name: Documents description: >- Upload documents, check processing status and link supporting evidence to transactions. - name: Legal Entities description: Manage the legal entities used in your accounting records. - name: Ledger Accounts description: Manage your chart of accounts and find accounts for journal entries. - name: Tags description: Create and manage tags to classify your records. - name: Accruals description: >- Create and post accruals, inspect their status and reverse eligible entries. - name: Cash Application description: Match deposits to invoices and manage the resulting cash applications. - name: Classification description: >- Classify transactions in a batch, post eligible entries and inspect the results. - name: Revaluation description: Run asset revaluations for an accounting period and check their results. - name: Accounting Periods description: Check whether a period is ready to close, then close or reopen it. - name: Income Statement description: View revenue, expenses and net income for a reporting period. - name: Balance Sheet description: View assets, liabilities and equity as of a reporting date. - name: Trial Balance description: Review ledger account balances and debit and credit totals. - name: Closing Positions description: View asset positions at the end of a reporting period. - name: Treasury Balances description: Review treasury balances by asset and source. - name: Realized Gains & Losses description: Review realized gains and losses from asset dispositions. - name: Asset Tax Lots description: Inspect asset tax lots, remaining quantities and cost basis. - name: Schedule of Dispositions description: >- Review asset dispositions and their proceeds, cost basis and gains or losses. - name: Financial Insights description: Review financial insights for your selected reporting context. - name: Agents description: Create agents, schedule their work and inspect their runs. - name: Memory description: Read, search and maintain the memory files your agents use. - name: Connections description: Connect providers, manage authorization and disconnect. - name: GL Mapping description: >- Map ledger accounts and legal entities to your ERP. Import legal entities, tags and chart of accounts. - name: Request description: Request information, documents or connections from a client. - name: Client description: Manage your firm’s client relationships. - name: Team description: Invite team members and manage their access to your firm. - name: Settings description: Read and update your firm settings. paths: /v1/reports/trial-balance: get: tags: - Trial Balance summary: Get trial balance description: >- Returns cumulative balances: opening balance plus activity through the ending period. Provide start_date and end_date; a window with no matching periods is rejected. operationId: get_trial_balance parameters: - name: tag_id in: query schema: type: string description: Prefixed tag ID (`tag_`) for segment filtering. - name: include_zero_rows in: query schema: type: boolean default: true description: >- Set to `false` to omit accounts with no balance or movement. Defaults to `true`. Totals always cover all accounts. - name: legal_entity_ids in: query required: false schema: type: array items: type: string description: Legal entity ID (`le_…`). example: le_507f1f77bcf86cd799439011 maxItems: 100 uniqueItems: true style: form explode: true description: Legal entities to include (`le_…`). Omit to include all. - name: start_date in: query required: false description: >- Inclusive interval start. Required unless `as_of` is `true`; omit it when `as_of` is `true`. schema: type: string format: date-time example: '2026-08-31T12:00:00Z' - name: end_date in: query required: true description: Inclusive interval end; start must not exceed end. schema: type: string format: date-time example: '2026-08-31T12:00:00Z' - name: verbosity in: query schema: type: string enum: - faithful - compact default: faithful description: >- `compact` returns the account ID, hierarchy and normal-balance fields. `faithful` returns all account fields. The figures are the same. - name: as_of in: query schema: type: boolean default: false description: >- Set to `true` to include every period from the first period through `end_date`. Requires `end_date`; `start_date` returns HTTP 400. Defaults to `false`. responses: '200': description: The request succeeded. headers: X-Request-Id: description: Support correlation ID. schema: type: string content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/TrialBalance' required: - data additionalProperties: false example: data: meta: zero_rows_omitted: false account_count: 0 total_account_count: 0 ledger_accounts: - id: lac_507f1f77bcf86cd799439011 name: Cash type: Asset normal_balance: debit sequence_number: 1000 parent_account_id: null is_postable: true is_clearing_account: false is_archived: false archived_at: null asset_type: null created_at: '2026-08-31T12:00:00Z' balances: - ledger_account_id: lac_507f1f77bcf86cd799439011 opening_balance: '0.00' closing_balance: '0.00' current_balance: '0.00' debits: '0.00' credits: '0.00' data_quality: is_balanced: false is_empty: false total_debits: '100.00' total_credits: '100.00' warnings: [] '400': description: >- The request is invalid. `error.fields` lists the fields to correct. Nothing was changed. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: VALIDATION_ERROR message: Invalid path, query or request body. request_id: req_example '401': description: The API key is missing, invalid or expired. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: UNAUTHORIZED message: Authentication is required. request_id: req_example '403': description: >- The API key does not have the required scope or is not associated with a user, or the action needs a review in the dashboard. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: FORBIDDEN message: Insufficient access to organization request_id: req_example '404': description: The resource does not exist, or your organization cannot access it. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: RESOURCE_NOT_FOUND message: Resource not found request_id: req_example '429': description: >- Too many requests. If the response has a `Retry-After` header, wait that many seconds before you retry. Otherwise, read `error.message`. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer minimum: 1 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: RATE_LIMITED message: Rate limit exceeded. Retry after 30s. request_id: req_example '500': description: >- An unexpected error occurred. A write can still have taken effect; check the resource before you retry. Give the `request_id` to support. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: INTERNAL_ERROR message: Internal server error request_id: req_example '503': description: >- A service that this operation needs is unavailable. If the response has a `Retry-After` header, wait that many seconds. Check for earlier accepted work before you send the request again. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer minimum: 1 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: SERVICE_UNAVAILABLE message: Service unavailable. request_id: req_example components: schemas: TrialBalance: type: object properties: meta: type: object description: Account counts after row filtering. properties: zero_rows_omitted: type: boolean description: >- `true` when all-zero accounts were filtered out of `ledger_accounts` and `balances`. account_count: type: integer description: Accounts present in this response. total_account_count: type: integer description: >- Accounts before filtering: the size of the organization's chart of accounts. `data_quality` totals are computed over this unfiltered set. ledger_accounts: type: array description: >- Accounts in the report. When `include_zero_rows` is `false`, only accounts with a balance or movement, and their parents. items: $ref: '#/components/schemas/LedgerAccount' balances: type: array items: type: object properties: ledger_account_id: type: string description: Ledger account (`lac_…`). opening_balance: type: string description: Balance at the start of the window (decimal string). closing_balance: type: string description: Balance at the end of the window (decimal string). current_balance: type: string description: Current balance (decimal string). debits: type: string description: Debits in the window (decimal string). credits: type: string description: Credits in the window (decimal string). description: Balances by ledger account. data_quality: type: object description: >- Checks on the trial balance. Use `is_balanced` and `is_empty`; the warning text can change. properties: is_balanced: type: boolean description: >- Total debits equal total credits across the leaf accounts, within half a cent. This is necessary but not sufficient; see `is_empty`. is_empty: type: boolean description: >- `true` when the report has no ledger accounts or every account is zero. total_debits: type: string description: Total debits across the leaf accounts (decimal string). total_credits: type: string description: Total credits across the leaf accounts (decimal string). warnings: type: array items: type: string description: >- Human-readable `[WARNING]` strings for any raised condition (does-not-foot, or empty). required: - ledger_accounts - balances ErrorResponse: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string description: Machine-readable error code. message: type: string description: Technical description for developers. fields: type: object additionalProperties: type: string description: >- Present only on VALIDATION_ERROR. Maps failing field paths to reason strings. details: type: object additionalProperties: true description: >- Optional redacted diagnostic details. Request validation uses fields or field_errors. suggested_action: type: string description: A suggested next step. documentation_url: type: string format: uri description: Link to documentation about this error. request_id: type: string description: Unique request ID for support escalation. description: Error details. LedgerAccount: type: object required: - id - name - type - normal_balance - is_postable - is_archived - created_at properties: id: type: string examples: - lac_789abc description: Ledger account ID (`lac_…`). name: type: string description: Ledger account name. type: type: string enum: - Asset - Liability - Equity - Income - Expense description: Account type. normal_balance: type: string enum: - debit - credit description: >- Computed from type. Asset/Expense = debit, Liability/Equity/Income = credit. sequence_number: type: - integer - 'null' description: >- Chart-of-accounts ordering code. Null when the stored value is not a valid non-negative integer. parent_account_id: type: - string - 'null' description: Parent account (`lac_…`), or `null` for a top-level account. is_postable: type: boolean description: >- `true` for a postable child account that accepts journal lines; `false` for a parent grouping account. is_clearing_account: type: boolean description: >- `true` for a clearing account used for internal transfers and payables. is_archived: type: boolean description: >- `true` when the account is archived. Earlier journal entries can still refer to it. List ledger accounts excludes archived accounts unless you set `include_archived=true`. archived_at: type: - string - 'null' format: date-time description: Time the account was archived, or `null` when it is not archived. asset_type: type: - string - 'null' description: Asset or currency that the account tracks, such as `ETH` or `USD`. created_at: type: string format: date-time description: Time the ledger account was created (ISO 8601). organization_id: type: - string - 'null' description: Organization ID (`org_…`). updated_at: type: - string - 'null' format: date-time description: Time the record was last updated (ISO 8601). securitySchemes: ApiKey: type: apiKey in: header name: X-API-Key description: >- Your organization API key. Some operations also need a key that is associated with a user; their pages say so. ````