Form 20-F Data

Form 20-F Data serves the content of a foreign private issuer’s annual Form 20-F filing with the SEC. Each observation belongs to one filing, addressed by section: the filing profile, as-reported segments, disclosed ownership, the notes, and the filing’s own XBRL facts. A 20-F is an annual filing — there are no quarterly rows in this dataset.

Plan: Professional and above · Credits: 1 per call

What You Can Use Form 20-F Data For

Read a non-US issuer’s segment breakdown as it reported it. See the holders the filing disclosed. Pull a specific XBRL fact from the filing’s own instance. Confirm which accounting standard and reporting currency a filing used before comparing it with anything.

The Financial Statements Are Not in This Dataset

The three financial statements are not served here. Income Statements, Balance Sheets and Cash Flow Statements are the single contract for them, and a covered 20-F filer’s annual IFRS statements are served there through the 20-F fallback.Look for a 20-F filer’s statements on the ordinary statement endpoints, not here.

The Form 20-F Sections

profile says which filing this is: its date, its accession number, its reporting currency, and whether it reports under IFRS or US GAAP. segments carries as-reported business and geographic breakdowns, filterable by dimension, metric or fiscal_year. ownership carries the holders the filing disclosed. notes carries the filing’s note disclosures. xbrl-facts carries the filing’s own XBRL instance.

Do Not Sum Form 20-F Ownership Rows

Board-as-a-group lines appear beside individual holders in the ownership section. Adding them together double-counts every board member.

XBRL Facts Require a Narrowing Parameter

A single XBRL instance holds thousands of facts, so the xbrl-facts section requires at least one of tag, accession or period_end. An unnarrowed request is rejected rather than returning an unusable page.

Form 20-F Date Convention

A 20-F covers a fiscal year. fiscal_year on the segments section selects one. period_end on the XBRL section selects facts by their period end date.

Form 20-F Sources

All content is read from the issuer’s own Form 20-F filing on SEC EDGAR, including the XBRL instance the issuer filed with it.

Query Form 20-F Data

Use the 20-F endpoints. Each section is its own route under the company’s 20f path.

string

required

A ticker, CIK, ISIN or company_id.

string

geographic or business. Segments section only.

string

For example revenue or assets. Segments section only.

integer

Fiscal year. Segments section only.

string

An XBRL tag. XBRL-facts section — at least one of tag, accession or period_end is required there.

string

One filing’s accession number.

string

Period end date, YYYY-MM-DD. XBRL-facts section.

integer

Rows per page, between 1 and 1000. Page through with cursor.

See also Income Statements and its siblings for a 20-F filer’s statements, Segmented Financials for the US-filer equivalent of the segments section, SEC Filings Index for the filing itself, and Exchange Disclosures for what the same issuer told its home market.

curl "https://api.focusalpha.ai/v1/companies/TSM/20f/segments?dimension=geographic&metric=revenue" \
  -H "Authorization: Bearer $FOCUSALPHA_API_KEY"

{
  "data": [
    {
      "company_id": "cmp_008395",
      "id": "1537",
      "cik": "1046179",
      "accession": "0001628280-26-025362",
      "dimension": "geographic",
      "segment_path": [
        "TW"
      ],
      "segment_name": "TW",
      "depth": 1,
      "consolidation": null,
      "is_elimination": false,
      "metric": "revenue",
      "tag": "ifrs-full:RevenueFromContractsWithCustomers",
      "period_end": "2024-12-31",
      "fiscal_year": 2024,
      "value": "270413500000",
      "currency": "TWD"
    }
  ],
  "next_cursor": "1537",
  "coverage": {
    "available_from": "2014-12",
    "available_to": null,
    "update_frequency": "annual",
    "history_status": "complete_for_covered_filers"
  }
}

Get started

Core concepts

Screening tools

ETF data

Company essentials

Ownership & incentives

Advisers & investors

Real-time events

Account

What You Can Use Form 20-F Data For

The Financial Statements Are Not in This Dataset

The Form 20-F Sections

Do Not Sum Form 20-F Ownership Rows

XBRL Facts Require a Narrowing Parameter

Form 20-F Date Convention

Form 20-F Sources

Query Form 20-F Data

​What You Can Use Form 20-F Data For

​The Financial Statements Are Not in This Dataset

​The Form 20-F Sections

​Do Not Sum Form 20-F Ownership Rows

​XBRL Facts Require a Narrowing Parameter

​Form 20-F Date Convention

​Form 20-F Sources

​Query Form 20-F Data

​Related Datasets

What You Can Use Form 20-F Data For

The Financial Statements Are Not in This Dataset

The Form 20-F Sections

Do Not Sum Form 20-F Ownership Rows

XBRL Facts Require a Narrowing Parameter

Form 20-F Date Convention

Form 20-F Sources

Query Form 20-F Data

Related Datasets