Financials

Balance sheet

GET/api/v2/balance-sheets

Coverage: US / CN / JP, the last 3 years
Billing: 20 cr / thousand calls

Point-in-time balance sheet values, one row per period, with 41 line-item columns plus the 12 common fields from the section preamble; period_start is always null. total_debt / net_debt are derived columns (not as-reported lines); the remaining columns are as-reported line-item values.

The example shows only a selection of line-item columns; the response field table is authoritative for the complete key set.

Shared financials conventions

US / CN / JP, the last 3 years; markets out of scope return 404 . The three statement endpoints take the same parameters (ticker / period / limit) and return one row per period, aligned on (ticker, fiscal_year, period); for each ticker they return the most recent limit periods in descending report_period order. Valuation and derived financial metrics are provided separately by /financial-metrics-snapshot.

period: FY (default) / Q1–Q4 / H1. Accepts multiple comma-separated values. Periods actually disclosed per market: US FY Q1–Q3 (no standalone Q4 single-quarter figure), CN FY Q1 H1 Q3, JP FY H1 (no quarterly reports); a period that does not exist returns an empty array (Q4 is currently not disclosed separately in any of the three markets and is always an empty array; the caller computes fourth-quarter flow figures itself: US = FY − Q1 − Q2 − Q3, CN = FY − Q3 (Q3 is year-to-date cumulative), and JP has no quarterly figures; /balance-sheets holds point-in-time values, so no such subtraction applies). There is no date filter; limit counts back from the most recent period.

Common fields (present on every row of all three statements):

Field	Type	Description
`ticker`	string	Canonical ticker (US has no suffix, e.g. `AAPL`; CN is `600519.SH`; JP is `7203.T`)
`market`	string	Market code: `US` / `CN` / `JP`
`fiscal_year`	int	Fiscal year
`period`	string	`FY` / `Q1`–`Q4` / `H1`
`period_start`	date	Period start date; null for `/balance-sheets`
`report_period`	date	Period end date
`currency`	string	Reporting currency
`accounting_standard`	string	`US-GAAP` / `IFRS` / `CN-GAAP` / `JP-GAAP`
`accession_number`	string	Native document number from the official source: US is the SEC accession (e.g. `0000320193-25-000123`), JP the EDINET docID, CN the cninfo announcement id
`form_type`	string	Type of the source filing, in the market's native encoding (US: SEC form names such as `10-K` / `10-Q`; JP: EDINET numeric codes; CN: `annual_report` and the like)
`filing_url`	string	Deep link to the official filing; opens the source document directly
`filing_date`	date	Filing date: the date the document became public on the official channel

Value conventions (common to all three statements):

Field names are cross-market canonical line-item names; values are numbers in the base unit of currency; line items that do not apply are null.
Cash outflows are negative, inflows positive.
Flow line items are as reported, no de-cumulation is applied, and the value corresponds to the [period_start, report_period] range: US quarterly reports carry single-quarter figures; the CN third-quarter report (Q3) is year-to-date cumulative, the single-quarter figure = Q3 − H1 and the fourth quarter = FY − Q3; the semi-annual report (H1) is cumulative for the first half.
For derived line items (ebitda / total_debt / net_debt / free_cash_flow), missing components count as 0; the value is null only when all components are missing.
Only GAAP / statutory-basis figures are returned; for non-GAAP numbers, use /filing-search.

Query parameters

Parameter	Type	Required	Description
ticker	string	required	Up to 10 tickers, comma-separated.
period	string	optional	FY / Q1–Q4 / H1; multiple values allowed, comma-separated; see the head of this section for which periods each market has. Default FY.
limit	int	optional	Number of periods per ticker, counting back from the most recent period; maximum 40. Default 4.

Response fields

Field	Type	Description
ticker	string	Canonical ticker (US has no suffix, e.g. AAPL; CN is 600519.SH; JP is 7203.T)
market	string	Market code: US / CN / JP
fiscal_year	int	Fiscal year
period	string	FY / Q1–Q4 / H1
period_start	date	Period start date; null for /balance-sheets
report_period	date	Period end date
currency	string	Reporting currency
accounting_standard	string	US-GAAP / IFRS / CN-GAAP / JP-GAAP
accession_number	string	Native document number from the official source: US is the SEC accession (e.g. 0000320193-25-000123), JP the EDINET docID, CN the cninfo announcement id
form_type	string	Type of the source filing, in the market's native encoding (US: SEC form names such as 10-K / 10-Q; JP: EDINET numeric codes; CN: annual_report and the like)
filing_url	string	Deep link to the official filing; opens the source document directly
filing_date	date	Filing date: the date the document became public on the official channel
cash_and_cash_equivalents	number	Monetary funds / cash and cash equivalents
short_term_investments	number	Short-term investments / financial assets held for trading
accounts_receivable	number	Accounts receivable (net)
inventories	number	Inventories
prepaid_expenses	number	Prepayments
other_current_assets	number	Other current assets
current_assets	number	Total current assets
property_plant_equipment	number	Property, plant and equipment, net
right_of_use_assets	number	Right-of-use assets (includes all leases; the US-GAAP operating lease ROU is merged in)
goodwill	number	Goodwill
intangible_assets	number	Intangible assets
long_term_investments	number	Long-term investments (including long-term equity investments)
deferred_tax_assets	number	Deferred tax assets
other_non_current_assets	number	Other non-current assets
non_current_assets	number	Total non-current assets
total_assets	number	Total assets
accounts_payable	number	Accounts payable
short_term_debt	number	Short-term borrowings. When a US filing discloses only a combined line for short-term debt and long-term debt due within one year, the entire line is recorded in this column and current_portion_of_long_term_debt is null (total_debt is unaffected)
current_portion_of_long_term_debt	number	Non-current liabilities due within one year / current maturities
employee_compensation_payable	number	Employee compensation payable
income_taxes_payable	number	Income taxes payable
accrued_liabilities	number	Accrued liabilities
deferred_revenue	number	Contract liabilities / deferred revenue (current portion only)
other_current_liabilities	number	Other current liabilities
current_liabilities	number	Total current liabilities
long_term_debt	number	Long-term borrowings / bonds payable
lease_liabilities	number	Lease liabilities (current + non-current, includes all leases)
deferred_tax_liabilities	number	Deferred tax liabilities
other_non_current_liabilities	number	Other non-current liabilities
non_current_liabilities	number	Total non-current liabilities
total_liabilities	number	Total liabilities
common_stock	number	Share capital
additional_paid_in_capital	number	Capital reserve
retained_earnings	number	Retained earnings / undistributed profits (CN includes the surplus reserve)
treasury_stock	number	Treasury stock (negative)
accumulated_other_comprehensive_income	number	Accumulated other comprehensive income
equity_attributable_to_parent	number	Equity attributable to parent
noncontrolling_interests	number	Noncontrolling interests
total_equity	number	Total equity
total_debt	number	Derived (not an as-reported line) = short_term_debt + current_portion_of_long_term_debt + long_term_debt
net_debt	number	Derived (not an as-reported line) = total_debt - cash_and_cash_equivalents - short_term_investments

Request

curl -H "X-API-KEY: $DRILLR_API_KEY" \
  "https://gateway.drillr.ai/api/v2/balance-sheets?ticker=AAPL&period=FY&limit=3"

Response · 200

{
  "data": [
    {
      "ticker": "AAPL",
      "market": "US",
      "fiscal_year": 2025,
      "period": "FY",
      "period_start": null,
      "report_period": "2025-09-27",
      "currency": "USD",
      "accounting_standard": "US-GAAP",
      "cash_and_cash_equivalents": 35934000000,
      "short_term_investments": 18763000000,
      "inventories": 5718000000,
      "current_assets": 147957000000,
      "property_plant_equipment": 49834000000,
      "total_assets": 359241000000,
      "accounts_payable": 69860000000,
      "short_term_debt": 7979000000,
      "current_portion_of_long_term_debt": 12350000000,
      "employee_compensation_payable": null,
      "current_liabilities": 165631000000,
      "total_liabilities": 285508000000,
      "long_term_debt": 78328000000,
      "retained_earnings": -14264000000,
      "equity_attributable_to_parent": 73733000000,
      "noncontrolling_interests": 0,
      "total_equity": 73733000000,
      "total_debt": 98657000000,
      "net_debt": 62723000000,
      "accession_number": "0000320193-25-000079",
      "form_type": "10-K",
      "filing_date": "2025-10-31",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt"
    }
  ]
}

No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.

Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.