Skip to main content
GET
/
api
/
reports
/
general-ledger
Get general ledger report
curl --request GET \
  --url https://api.example.com/api/reports/general-ledger \
  --header 'Authorization: <authorization>' \
  --header 'accept: <accept>' \
  --header 'organization-id: <organization-id>'
{
  "query": {
    "fromDate": "<string>",
    "toDate": "<string>",
    "basis": "cash",
    "numberFormat": {
      "precision": 2,
      "divideOn1000": false,
      "showZero": true,
      "formatMoney": "total",
      "negativeFormat": "parentheses"
    },
    "noneZero": true,
    "accountsIds": [
      123
    ]
  },
  "data": [
    {
      "id": 123,
      "name": "<string>",
      "code": "<string>",
      "index": 123,
      "openingBalance": {
        "amount": 123,
        "formattedAmount": "<string>",
        "currencyCode": "<string>",
        "date": {}
      },
      "transactions": [
        {
          "date": "<string>",
          "dateFormatted": "<string>",
          "referenceType": "<string>",
          "referenceId": 123,
          "transactionTypeFormatted": "<string>",
          "contactName": "<string>",
          "contactType": "<string>",
          "transactionType": "<string>",
          "index": 123,
          "credit": 123,
          "debit": 123,
          "amount": 123,
          "runningBalance": 123,
          "formattedAmount": "<string>",
          "formattedCredit": "<string>",
          "formattedDebit": "<string>",
          "formattedRunningBalance": "<string>",
          "currencyCode": "<string>",
          "transactionNumber": "<string>",
          "note": "<string>"
        }
      ],
      "closingBalance": {
        "amount": 123,
        "formattedAmount": "<string>",
        "currencyCode": "<string>",
        "date": {}
      },
      "parentAccountId": 123
    }
  ],
  "meta": {
    "organizationName": "<string>",
    "baseCurrency": "<string>",
    "dateFormat": "<string>",
    "isCostComputeRunning": true,
    "sheetName": "<string>",
    "formattedFromDate": "<string>",
    "formattedToDate": "<string>",
    "formattedDateRange": "<string>"
  }
}

Headers

Authorization
string
required

Value must be 'Bearer ' where is an API key prefixed with 'bc_' or a JWT token.

Example:

"Bearer bc_1234567890abcdef"

organization-id
string
required

Required if Authorization is a JWT token. The organization ID to operate within.

accept
string
required

Query Parameters

basis
string

Accounting basis for the report (e.g., cash, accrual)

Example:

"accrual"

precision
number

Number of decimal places to display

Example:

2

divideOn1000
boolean

Whether to divide the number by 1000

Example:

false

showZero
boolean

Whether to show zero values

Example:

true

formatMoney
enum<string>

How to format money values

Available options:
total,
always,
none
Example:

"total"

negativeFormat
enum<string>

How to format negative numbers

Available options:
parentheses,
mines
Example:

"parentheses"

noneTransactions
boolean
default:false

Whether to exclude transactions from the report

Example:

false

accountsIds
number[]

Array of account IDs to filter the report

Example:
[1, 2, 3]

Response

General ledger report

query
object
required

Query parameters used to generate the report

data
object[]
required

General ledger data

meta
object
required

Report metadata