---
title: "Read dual-basis reporting settings"
method: GET
path: "/reports/basis-settings"
tags: ["Reports"]
---

# Read dual-basis reporting settings

`GET /reports/basis-settings`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/reports/basis-settings`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Returns the company's default reporting basis, cash coverage start date, explicit control-account bindings, and account-role diagnostics.

## Response `200`

Reporting basis settings

- ReportBasisSettingsResponse
  - `settings` object
    - `id` string, uuid
    - `defaultReportBasis` 'accrual' | 'cash'
    - `arAccountId` string, uuid, nullable
    - `apAccountId` string, uuid, nullable
    - `taxLiabilityAccountId` string, uuid, nullable
    - `taxInputAccountId` string, uuid, nullable
    - `customerPrepaymentAccountId` string, uuid, nullable
    - `vendorPrepaymentAccountId` string, uuid, nullable
  - `accounts` Account[]
    - `id` string, uuid
    - `code` string
    - `name` string
    - `type` 'asset' | 'liability' | 'equity' | 'revenue' | 'expense'
    - `classification` 'asset' | 'liability' | 'equity' | 'revenue' | 'expense'
    - `active` boolean
    - `postable` boolean
    - `reportingRole` 'cash' | 'accounts_receivable' | 'accounts_payable' | 'sales_tax_payable' | 'purchase_tax_receivable' | 'customer_prepayment' | 'vendor_prepayment' | 'inventory' | 'prepaid_expense' | 'fixed_asset' | 'accumulated_depreciation' | 'credit_card' | 'debt' | 'equity' | 'revenue' | 'cost_of_goods_sold' | 'expense' | 'other' | 'null', nullable: Explicit chart-account reporting role used by dual-basis reports and control-account validation.
    - `ledgerHqRoles` string[]
  - `bindings` object

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)