Filings
Filing list
- Coverage
- US, the last 5 years · JP / CN, financial reports for the last 3 years
- Billing
- 20 cr / thousand calls
Returns filing metadata for a company within the retention window, queried by ticker; one row per filing under each ticker, in descending filing_date order (same-day ties in descending accession_number order). The market comes from the canonical ticker; the time range is fixed to the retention window (US 5 years / JP · CN 3 years), and the endpoint provides no date parameter and no market-wide scan.
- Row identity =
ticker+accession_number. When one filing involves several companies (such as SC 13D / 13G), the endpoint returns one row under each related ticker. - There is no date parameter, so filings arriving while the caller pages through the result can make adjacent pages repeat or drop rows; in strict scenarios, de-duplicate by
ticker+accession_number. - To tell whether a filing is an amendment, check the
/A/訂正/更正suffix onform_type; company names come from/company-profile; body-text search goes through/filing-search.
Shared filings conventions
Retention scope: US: all form types from the last 5 years; JP / CN: the last 3 years, financial report types only (JP: 有価証券報告書 annual / 半期報告書 semi-annual / 四半期報告書 quarterly, and their 訂正 amendments; CN: 年度报告 annual / 半年度报告 semi-annual / 季度报告 quarterly, and their 更正 amendments); the window rolls on filing_date. HK / KR / TW return 404. In JP / CN, non-financial-report types (ad hoc announcements, timely disclosures, and so on) are out of scope: neither endpoint returns those rows, and explicitly requesting such a form_type returns 404. An unrecognized form_type (one that matches no native type of that market) returns 400; the endpoints do not silently return an empty array.
The type axis uses only each market's native form_type; there is no cross-market unified type enum. To filter by type across markets, callers combine each market's native codes.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | required | Up to 10 tickers, comma-separated. |
| form_type | string | optional | Market-native type (source encoding, verbatim): 10-K 10-Q 8-K 年度报告 有価証券報告書 and so on, comma-separated for multiple values. Filings by US companies are dominated by routine documents such as Form 3/4/5/144; specifying the type explicitly is recommended when querying annual or quarterly reports. Default All types within the retention scope. |
| limit | int | optional | Maximum 500. Default 50. |
| page | int | optional | Starts at 1. Default 1. |
Sorted filing_date desc, accession_number desc. Paged with limit and page (pages start at 1); fewer rows than limit means the last page.
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 |
| form_type | string | Filing type, returned verbatim in the market's native encoding (US: SEC form names such as 10-K / 8-K; JP: EDINET numeric codes 120 / 140 and TDnet labels; CN: annual_report / q1_report and the like) |
| title | string | Filing title (in the original language) |
| filing_date | date | Filing date |
| period_of_report | date | Report period end date |
| 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 |
| filing_url | string | Deep link to the official filing; opens the source document directly |
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.