Plan: Free and above · Credits: 1 per call
What You Can Use Taiwan Cash Flow For
Measure how much cash a Taiwan company generates and how much it reinvests. Build a quarterly capex and depreciation series for a semiconductor or hardware name. Track free cash flow, leverage and net cash. Check whether reported earnings are turning into cash.Why Cash Flow Is Its Own Endpoint
The summary tables behind Taiwan Financials print no cash-flow statement and no balance-sheet detail beyond the three totals and share capital. The figures here are read from the inline XBRL originals of the same filed reports instead, so they carry a different set of fields and a shorter history. If a cash, capex or borrowings question comes back empty from the financials endpoint, this is the endpoint to use.Cash Flows Are Filed Cumulatively
Every flow line therefore comes back twice. The_ytd fields — operating_cf_ytd, investing_cf_ytd, financing_cf_ytd, fx_effect_ytd, net_change_ytd, capex_ytd, intangible_capex_ytd, depreciation_ytd, amortisation_ytd and free_cash_flow_ytd — are the figure as filed, cumulative.
The _q fields with the same names are the single quarter.
How to Read quarter_basis
quarter_basis says how the _q values were arrived at.
as_reported means season 1, where the cumulative figure is already the quarter.
derived_from_ytd means this season’s cumulative figure minus the previous season’s.
null means the previous season is missing, in which case the _q fields are null. Those nulls must not be treated as zero.
Point-in-Time Fields Have No Quarter Version
cash_begin, cash_end, cash, inventories, ppe, lt_borrowings, st_borrowings, lease_liab_current, lease_liab_noncurrent and net_debt are balances at a date. They never accumulate, so they have no _q form.
Key Taiwan Cash Flow Fields
capex is purchases of property, plant and equipment and is negative, as filed. intangible_capex is purchases of intangible assets, reported separately.
free_cash_flow is operating cash flow plus capex. Because capex is already negative, this is operating cash flow less capex, and it does not deduct intangible_capex.
net_debt is borrowings plus lease liabilities minus cash. Negative means net cash. A borrowing or lease field that is null on the row contributes nothing to net_debt, so check those fields before reading a small net debt as low leverage.
A null financing_cf_ytd is normal: a company with no financing activity in the period does not print the line.
Check cf_closes Before Trusting a Row
cf_closes checks the filing against itself: the three subtotals plus the FX effect against the reported net change in cash.
true means the row adds up. false means it does not, and the row should not be trusted. null means one of the legs was missing, so it could not be checked.
Consolidated Where the Company Files It
basis names the report the row came from: cr consolidated, ir parent-only, or er, the remaining variant. Consolidated is used where it exists. Companies with no subsidiaries file no consolidated statements, so their rows are ir rather than absent.
Do not mix bases when comparing companies.
Taiwan Cash Flow Date Convention
year is the fiscal year and season is the TWSE season, 1 to 4. Each row also carries period_start, period_end and period_months, the length of the cumulative window: 3 for season 1 and 12 for season 4.
Rows are returned newest first, one row per company per season.
Taiwan Cash Flow Units
Amounts are TWD thousands. The response statescurrency and unit explicitly — read them rather than assuming a scale.
Taiwan Cash Flow Coverage
Coverage starts at 2024 Q1, for about 2,700 companies. That is a shorter history than Taiwan Financials, which starts at 2013 Q1, because the inline XBRL originals are read directly.GET /v1/companies/{company_id}/tw/cashflow
Quarterly cash-flow statements and balance-sheet detail, newest first.string
required
A Taiwan security code such as
2330, a suffixed ticker such as 2330.TW or 6976.TWO, an ISIN or a company_id.integer
Fiscal year.
integer
TWSE season, 1 to 4.
string
next_cursor from the previous page.integer
default:"40"
Rows per page, between 1 and 1000.