All APIs

Balance sheet API for company financial position

Get standardised assets, liabilities and equity, with derived working capital and net debt and lease liabilities kept outside total debt.

First request

Quickstart →

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=balance" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

Example response Illustrative response · not a live request

{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "cash": "20935000000",
      "total_assets": "758376000000",
      "total_liabilities": "315989000000",
      "total_equity": "442387000000"
    }
  ]
}

Endpoints

GETGet standardised company financial statements/v1/companies/{company_id}/financials

Understand the reported position

Working capital

Calculated as current assets minus current liabilities and marked as derived.

Net debt

Calculated as total debt minus cash, excluding leases.

Lease liabilities

Reported separately and excluded from total debt.

Coverage

View coverage →

Coverage: US, Japan, Korea, EU/EEA, the UK and Taiwan; US history from 2009.

Response fields

cash: Cash and readily convertible short-term cash equivalents; for banks, cash and amounts due from other banks.
short_term_investments: Short-term investments and marketable securities.
long_term_investments: Investments reported as long-term assets on the balance sheet.
receivables: Amounts owed by customers and others that are classified as current assets.
inventory: Goods held for sale, work in progress and materials or supplies used in production.
total_current_assets: Assets classified as current, generally realized, sold or used within the operating cycle or one year.
working_capital: Calculated as current assets minus current liabilities; marked as derived.
ppe_net: Tangible assets used in the business, after accumulated depreciation and impairment.
goodwill: The asset recognized when a business acquisition costs more than the fair value of its identifiable net assets.
intangibles: Non-physical assets recognized on the balance sheet, excluding goodwill.
total_assets: The total carrying amount of assets recognized on the balance sheet.
total_current_liabilities: Obligations classified as current, generally settled within the operating cycle or one year.
accounts_payable: Amounts owed to suppliers and others that are classified as current liabilities.
deferred_revenue: Deferred revenue and contract liabilities.
short_term_debt: Borrowings due within one year, including the current portion of long-term debt.
long_term_debt: Borrowings due after one year, excluding the current portion.
lease_liabilities: Liabilities arising from leases, excluded from total debt.
total_debt: Short-term and long-term borrowings combined, excluding lease liabilities.
net_debt: Calculated as total debt minus cash, excluding lease liabilities; marked as derived.
total_liabilities: The total carrying amount of obligations recognized on the balance sheet.
retained_earnings: Cumulative profits retained after distributions, or accumulated losses.
equity_parent: Ownership interests attributable to the parent company's owners.
noncontrolling_interest: Equity in subsidiaries attributable to owners other than the parent company.
temporary_equity: Redeemable non-controlling interests and redeemable preferred shares presented between liabilities and equity.
total_equity: Total ownership interests in the company, including non-controlling interests.
total_liabilities_and_equity: The combined total of liabilities and equity reported on the balance sheet.
deposits: Amounts deposited by customers with a bank.
loans: Banks' loans and advances to customers, net of allowances for credit losses.